Ìwé API AfricaProxies

Ìmúdájú ìwọlé

Gbogbo ìbéèrè yàtọ̀ sí kátálọ́ọ̀gù gbangba ní kọ́kọ́rọ́ API: Authorization: Bearer API_KEY. A fi kọ́kọ́rọ́ hàn ní kíkún lẹ́ẹ̀kan, nígbà tí o ṣẹ̀dá rẹ̀: pa á mọ́ bí ọ̀rọ̀ aṣínà. O lè fagilé kọ́kọ́rọ́ nígbàkigbà; ìbéèrè tí a fi í ṣe lẹ́yìn náà ń dá 401 unauthorized padà.

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

Àwọn ìbéèrè àti èsì

• JSON wọlé, JSON jáde: fi Content-Type: application/json ránṣẹ́ pẹ̀lú ara.
• Àtòjọ tó lè gùn ni a pín sí ojú ìwé pẹ̀lú page (láti 1) àti perPage (1–100, àiyípadà 20), wọ́n sì ń dá { "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } } padà. Àtòjọ kúkúrú ń dá { "data": [...] } padà.
• Àmì ìdánimọ̀ jẹ́ ọ̀wọ́ ìkọ̀wé tí a kò túmọ̀, pẹ̀lú àmì irú rẹ̀ ní ìbẹ̀rẹ̀: ord_ (àṣẹ rírà), top_ (ìfikún owó), txn_ (ìṣípò owó àkáǹtì), res_ (ètò dátà), mob_ (ibùdó alágbèéká), key_ (kọ́kọ́rọ́ API) àti ipw_ (ìforúkọsílẹ̀ àtòjọ IP tí a fàyè gbà).
• Ìgbìyànjú àtúnṣe tó ní ààbò: POST /v1/orders àti POST /v1/topups gba akọlé Idempotency-Key (ọ̀wọ́ ìkọ̀wé aláìlẹ́gbẹ́ èyíkéyìí, tí a pa mọ́ fún 24 h). Lílo kọ́kọ́rọ́ kan náà tún ń dá èsì àkọ́kọ́ padà dípò rírà tàbí fífi owó kún àkáǹtì lẹ́ẹ̀mejì.
• Àpẹẹrẹ ń fi ìrísí èsì kọ̀ọ̀kan hàn: àmì ìdánimọ̀, àdírẹ́sì, iye àti ọjọ́ inú wọn jẹ́ àpẹẹrẹ; àmì ètò àti iye owó jẹ́ ti gidi.

Àwọn àṣìṣe

Gbogbo àṣìṣe ní ara kan náà. code dúró ṣinṣin, a sì ṣe é fún kóòdù rẹ; message jẹ́ gbólóhùn Gẹ̀ẹ́sì tí ó lè yípadà. Àṣìṣe ìmúdájú ń ṣàtòjọ àyè kọ̀ọ̀kan tí kò pé nínú fields. A lè fi kóòdù tuntun kún un: bójú tó èyí tí o kò mọ̀ bí ìkùnà gbogbogbò.

{
  "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"
  }
}

Ààlà iye ìpè

Gbogbo èsì ní RateLimit-Limit, RateLimit-Remaining àti RateLimit-Reset. Lókè ààlà, API ń dá 429 rate_limited padà pẹ̀lú akọlé Retry-After (ìṣẹ́jú-àáyá): dúró fún àkókò náà, lẹ́yìn náà tún gbìyànjú. A lè yí IP ibùdó alágbèéká padà lẹ́ẹ̀kan péré ní gbogbo ìṣẹ́jú-àáyá 30 (429 rotation_too_soon, pẹ̀lú Retry-After).