የAfricaProxies API ሰነድ

የመለያ ማረጋገጫ

ከይፋ ካታሎጉ በስተቀር እያንዳንዱ ጥያቄ API ቁልፍ ይዟል፦ Authorization: Bearer API_KEY። ቁልፍ ሲፈጥሩት በሙሉ አንድ ጊዜ ይታያል፤ እንደ ይለፍ ቃል ያስቀምጡት። በማንኛውም ጊዜ ቁልፍ ይሰርዙ፤ ከዚያ በእሱ የሚደረጉ ጥያቄዎች 401 unauthorized ይመልሳሉ።

curl -s "https://africaproxies.com/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"

ጥያቄዎችና ምላሾች

• JSON ይገባል፣ JSON ይወጣል፦ Content-Type: application/json ከአካል ጋር ይላኩ።
• ሊያድጉ የሚችሉ ዝርዝሮች በ page (ከ 1) እና perPage (1–100፣ ነባሪ 20) በገጽ ይከፈላሉ፣ { "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } } ይመልሳሉ። አጭር ዝርዝሮች { "data": [...] } ይመልሳሉ።
• መለያዎች ትርጉም የማይወሰድባቸው የጽሑፍ ሕብረቁምፊዎች ሲሆኑ፣ የዓይነት ቅድመ ቅጥያ አላቸው፦ ord_ (ትዕዛዝ)፣ top_ (ሂሳብ መሙያ)፣ txn_ (የቀሪ ሂሳብ እንቅስቃሴ)፣ res_ (የትራፊክ ምዝገባ)፣ mob_ (የሞባይል ፖርት)፣ key_ (የAPI ቁልፍ) እና ipw_ (የተፈቀዱ IP ዝርዝር ግቤት)።
• ደህንነታቸው የተጠበቁ ድጋሚ ሙከራዎች፦ POST /v1/orders እና POST /v1/topups የ Idempotency-Key ራስጌ ይቀበላሉ (ማንኛውም ልዩ ሕብረቁምፊ፣ ለ24 ሰዓት ይቆያል)። ተመሳሳይ ቁልፍ ደግሞ መጠቀም ሁለት ጊዜ ከመግዛት ወይም ሂሳብ ከመሙላት ይልቅ የመጀመሪያውን ምላሽ ይመልሳል።
• ምሳሌዎች የእያንዳንዱን ምላሽ ቅርጽ ያሳያሉ፤ መለያዎቻቸው፣ አድራሻዎቻቸው፣ መጠኖቻቸውና ቀኖቻቸው ለማሳያ ናቸው፣ የእቅድ መለያዎችና ዋጋዎች ግን እውነተኛዎቹ ናቸው።

ስህተቶች

እያንዳንዱ ስህተት ተመሳሳይ አካል አለው። code ቋሚ ነው፣ ለፕሮግራምዎም የታሰበ ነው፤ message ሊለወጥ የሚችል የእንግሊዝኛ ዓረፍተ ነገር ነው። የማረጋገጫ ስህተቶች እያንዳንዱን ልክ ያልሆነ መስክ በ fields ይዘረዝራሉ። አዲስ ኮዶች ሊጨመሩ ይችላሉ፤ የማያውቋቸውን ኮዶች እንደ አጠቃላይ አለመሳካት ያስተናግዱ።

{
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": [
      {
        "field": "amountUsd",
        "code": "too_small",
        "message": "The minimum top-up is 25.00 USD."
      }
    ],
    "requestId": "req_2b7c0f"
  }
}

የጥሪ ብዛት ገደቦች

እያንዳንዱ ምላሽ RateLimit-Limit፣ RateLimit-Remaining እና RateLimit-Reset ይዟል። ከገደቡ በላይ፣ API 429 rate_limited ከ Retry-After ራስጌ ጋር (በሰከንድ) ይመልሳል፤ ያንን ጊዜ ይጠብቁ፣ ከዚያ እንደገና ይሞክሩ። የሞባይል ፖርት IP ቢበዛ በእያንዳንዱ 30 ሰከንድ አንድ ጊዜ ሊቀየር ይችላል (429 rotation_too_soon፣ ከ Retry-After ጋር)።