# Ìwé API AfricaProxies

> AfricaProxies REST API ní africaproxies.com/api: kọ́kọ́rọ́ API, àṣìṣe, ààlà, owó àkáǹtì, ìfikún krípító, àṣẹ, proxy àti yíyí IP.

- URL: https://africaproxies.com/yo/docs/api/
- Ìgbà tí a mú ohun ṣe àtúnṣe: 2026-10-15
- Olùfúnró: AfricaProxies (https://africaproxies.com)

O lè fi script ṣe gbogbo ohun tí o ń ṣe nínú àkáǹtì rẹ: ṣàyẹ̀wò owó tó kù, fi krípító kún un, ra ètò, ṣẹ̀dá àlàyé ìwọlé proxy, yí IP alágbèéká padà. JSON lórí HTTPS, kọ́kọ́rọ́ API kan, àpẹẹrẹ ní curl, Python àti Node.js.

**Ìdáhùn kíkúrọ — Báwo ni mo ṣe lo API AfricaProxies?**

Fi ìbéèrè HTTPS ránṣẹ́ sí `https://africaproxies.com/api/v1` pẹ̀lú kọ́kọ́rọ́ API rẹ nínú akọlé `Authorization: Bearer API_KEY`. Ṣẹ̀dá kọ́kọ́rọ́ lórí [ojú ìwé olùgbékalẹ̀](/app/developer?lang=yo) àkáǹtì rẹ (tàbí pẹ̀lú `POST /v1/api-keys`), kí o sì fún un ní àṣẹ tó nílò nìkan. JSON ni ìbéèrè àti èsì; àṣìṣe máa ń padà bí `{ "error": { "code", "message" } }`.

## Ní ṣókí

| Àpẹẹrẹ | Ìwé |
| --- | --- |
| URL ìpìlẹ̀ | `https://africaproxies.com/api/v1` |
| Ìlànà | JSON lórí HTTPS, UTF-8 |
| Ìmúdájú ìwọlé | Kọ́kọ́rọ́ API: `Authorization: Bearer API_KEY` |
| Àwọn àṣẹ kọ́kọ́rọ́ API | `read`, `proxies`, `billing` |
| Owó | USD bí ọ̀wọ́ ìkọ̀wé pẹ̀lú ibi mẹ́wàá 2 (`"29.00"`) |
| Iye krípító | Ọ̀wọ́ ìkọ̀wé nọ́mbà onídéṣímà, kì í ṣe floats (`"0.00045210"`) |
| Dátà tí a firánṣẹ́ àti gbà | Bytes (1 GB = 1,000,000,000 bytes) |
| Àwọn ọjọ́ | ISO 8601 ní UTC (`2026-10-05T14:03:11Z`) |
| Ẹ̀dà | `/v1` nínú gbogbo ọ̀nà |

## Ì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à.

### Àwọn àṣẹ

Fún kọ́kọ́rọ́ kọ̀ọ̀kan ní ohun tí script rẹ nílò nìkan. Kọ́kọ́rọ́ tí kò ní àṣẹ tó yẹ ń gba `403 forbidden`.

| Àṣẹ | Ohun tí ó fàyè gbà |
| --- | --- |
| `read` | ka gbogbo rẹ̀ (àkáǹtì, owó tó kù, iṣẹ́, ìlò). |
| `proxies` | yí ètò proxy àti àlàyé ìwọlé padà (àmi, ìsọdọtun aládàáṣiṣẹ́, ọ̀rọ̀ aṣínà tuntun), ṣàkóso oníṣe abẹ́, ṣàkóso àtòjọ IP tí a fàyè gbà, kí o sì yí ibùdó alágbèéká padà (pẹ̀lú ọ̀nà àsopọ̀ yíyípadà). |
| `billing` | ṣẹ̀dá àṣẹ rírà àti ìfikún owó, san láti owó àkáǹtì. |

Ohun kan ṣoṣo tí ó yàtọ̀ ni **àsopọ̀ yíyípadà alágbèéká**, tí a ṣe fún ìpè láti àmì ojú ìwé aṣàwákiri tàbí `curl` lasan: `GET https://africaproxies.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (kọ́kọ́rọ́ pẹ̀lú àṣẹ `proxies`). Wo [Ibùdó alágbèéká àti yíyí IP](/yo/docs/api/mobile/).

*Ṣàyẹ̀wò owó àkáǹtì rẹ*

```bash
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ò.

*422 validation_failed*

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

### Àwọn kóòdù ipò

| Ipò | Ìtumọ̀ |
| --- | --- |
| `422` | `validation_failed`: àyè kan tàbí jù bẹ́ẹ̀ lọ kò pé. |
| `401` | `unauthorized`: token kò sí, kò pé tàbí àkókò rẹ̀ ti kọjá. |
| `402` | `insufficient_balance`: owó àkáǹtì kò tó fún àṣẹ rírà. `details` = `InsufficientBalanceDetails`. |
| `403` | `forbidden`: kọ́kọ́rọ́ API kò ní àṣẹ tó yẹ, tàbí a ti dá àkáǹtì dúró. |
| `404` | `not_found`: ohun tí a béèrè kò sí tàbí ó jẹ́ ti àkáǹtì mìíràn. |
| `409` | `conflict` (tàbí kóòdù pàtó sí i): a kò lè ṣe ìṣe náà ní ipò lọ́wọ́lọ́wọ́. |
| `429` | `rate_limited` tàbí `rotation_too_soon`. |

## Àà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`).

## Ìtọ́kasí API

- **[Àkáǹtì àti owó tó kù](/yo/docs/api/account/)** — Ka ètò àkáǹtì rẹ, owó USD tí a ti san tẹ́lẹ̀ àti gbogbo ìṣípò owó náà (ìfikún, rírà, ìdápadà owó).
- **[Fífi krípító kún àkáǹtì](/yo/docs/api/top-ups/)** — Fi krípító kún owó àkáǹtì: gba àdírẹ́sì ìfowópamọ́ àti iye gan-an, fi iye náà ránṣẹ́, jẹ́rìí pé o ti fi owó ránṣẹ́ (ID ìdúnàádúrà jẹ́ àṣàyàn), lẹ́yìn náà tẹ̀lé ìfikún títí a fi owó sí àkáǹtì. Owó náà ń san fún gbogbo ètò wa.
- **[Àṣẹ rírà](/yo/docs/api/orders/)** — Ṣàtòjọ ètò àti iye owó, ra ètò láti owó àkáǹtì (iṣẹ́ tuntun, dátà sí i tàbí àfikún àkókò ibùdó), kí o sì ka àṣẹ rírà rẹ àtijọ́.
- **[Proxy ilé àti àlàyé ìwọlé](/yo/docs/api/residential/)** — Ṣàkóso ètò dátà (ti ilé àti 4G/5G tí ń yípadà fún GB): àlàyé ìwọlé proxy, oníṣe abẹ́ pẹ̀lú àlàyé ìwọlé àti ààlà dátà tirẹ̀, ìlò ojoojúmọ́ àti ibi tí o lè yàn nínú orúkọ oníṣe proxy.
- **[Ibùdó alágbèéká àti yíyí IP](/yo/docs/api/mobile/)** — Ibùdó 4G/5G tí a yà sọ́tọ̀: yí IP padà báyìí tàbí lórí aago, lo àsopọ̀ yíyípadà, kí o sì ka dátà ojoojúmọ́.
- **[Kọ́kọ́rọ́ API àti àtòjọ IP tí a fàyè gbà](/yo/docs/api/api-keys/)** — Ṣẹ̀dá kí o sì fagilé kọ́kọ́rọ́ API pẹ̀lú àṣẹ tó ní ààlà, kí o sì ṣàkóso àtòjọ IP tí a fàyè gbà: àdírẹ́sì orísun tó pọ̀ jù lọ 10 lè lo proxy láìsí orúkọ oníṣe àti ọ̀rọ̀ aṣínà.

> **Ìsanwó láti script** A máa ń san fún ètò láti owó USD tí a ti fi sí àkáǹtì tẹ́lẹ̀. Fi krípító kún un (ó kéré jù $25) pẹ̀lú POST /v1/topups, lẹ́yìn náà ra pẹ̀lú POST /v1/orders. Méjèèjì lè wà nínú ìpè kan: ìfikún owó lè gbé àṣẹ rírà nínú purchase, a sì ra ètò ní kété tí a fi ìfikún sí àkáǹtì.

---

AfricaProxies: AfricaProxies jẹ́ olùpèsè proxy IP ilé fún Áfíríkà gúúsù Sàhárà; a ń sanwó pẹ̀lú krípító láìgbé ẹ̀rí ìdánimọ̀ sókè.