# የAfricaProxies API ሰነድ

> የAfricaProxies REST API በ africaproxies.com/api: የAPI ቁልፎች፣ ስህተቶች፣ ገደቦችና የቀሪ ሂሳብ፣ የክሪፕቶ መሙያ፣ የትዕዛዝ፣ የproxy እና የሞባይል IP ማለዋወጫ መዳረሻዎች።

- URL: https://africaproxies.com/am/docs/api/
- የመጨረሻው መዘመን: 2026-10-15
- አሳቢ: AfricaProxies (https://africaproxies.com)

በሂሳብዎ የሚያደርጉትን ሁሉ በስክሪፕት ማስኬድ ይችላሉ፦ ቀሪ ሂሳብን ማየት፣ በክሪፕቶ መሙላት፣ እቅድ መግዛት፣ የproxy መግቢያ መረጃ መፍጠር፣ የሞባይል IP ማለዋወጥ። JSON በ HTTPS፣ አንድ API ቁልፍ፣ ምሳሌዎች በ curl፣ Python እና Node.js።

**ፈጣን መልስ — የAfricaProxies API እንዴት እጠቀማለሁ?**

የHTTPS ጥያቄዎችን ወደ `https://africaproxies.com/api/v1` ከAPI ቁልፍዎ ጋር በ `Authorization: Bearer API_KEY` ራስጌ ይላኩ። ቁልፉን በሂሳብዎ [የአልሚ ገጽ](/app/developer?lang=am) (ወይም በ `POST /v1/api-keys`) ይፍጠሩ፣ የሚያስፈልገውን የፈቃድ ወሰን ብቻ ይስጡት። ጥያቄዎችና ምላሾች JSON ናቸው፤ ስህተቶች ሁልጊዜ በ `{ "error": { "code", "message" } }` መልክ ይመለሳሉ።

## በአጭሩ

| ባህሪ | ዋጋ |
| --- | --- |
| መሠረታዊ URL | `https://africaproxies.com/api/v1` |
| ቅርጽ | JSON በ HTTPS፣ UTF-8 |
| የመለያ ማረጋገጫ | የAPI ቁልፍ፦ `Authorization: Bearer API_KEY` |
| የAPI ቁልፍ የፈቃድ ወሰኖች | `read`, `proxies`, `billing` |
| ገንዘብ | USD በሕብረቁምፊ፣ በ2 የአስርዮሽ ቦታዎች (`"29.00"`) |
| የክሪፕቶ መጠኖች | የአስርዮሽ ሕብረቁምፊዎች፣ ፈጽሞ ተንሳፋፊ ነጥብ አይደሉም (`"0.00045210"`)። |
| ትራፊክ | ባይቶች (1 GB = 1,000,000,000 ባይቶች) |
| ቀኖች | ISO 8601 በ UTC (`2026-10-05T14:03:11Z`) |
| ስሪት | በእያንዳንዱ መስመር `/v1` |

## የመለያ ማረጋገጫ

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

### የፈቃድ ወሰኖች

ለእያንዳንዱ ቁልፍ ስክሪፕትዎ የሚያስፈልገውን ብቻ ይስጡ። አስፈላጊው ፈቃድ የሌለው ቁልፍ `403 forbidden` ያገኛል።

| የፈቃድ ወሰን | የሚፈቅደው |
| --- | --- |
| `read` | ሁሉንም ማንበብ (ሂሳብ፣ ቀሪ ሂሳብ፣ አገልግሎቶች፣ አጠቃቀም)። |
| `proxies` | የproxy ቅንብሮችንና የመግቢያ መረጃዎችን መቀየር (መለያዎች፣ ራስ-ሰር እድሳት፣ አዲስ ይለፍ ቃሎች)፣ ንዑስ ተጠቃሚዎችንና የተፈቀዱ IP ዝርዝርን ማስተዳደር፣ የሞባይል ፖርቶችንም ማለዋወጥ (የማለዋወጫ አገናኙን ያካትታል)። |
| `billing` | ትዕዛዞችንና የሂሳብ መሙያዎችን መፍጠር፣ ከቀሪ ሂሳብ መክፈል። |

ብቸኛው ልዩ ሁኔታ **የሞባይል ማለዋወጫ አገናኝ** ነው፤ ከአሳሽ ዕልባት ወይም ከቀላል `curl` እንዲጠራ ተዘጋጅቷል፦ `GET https://africaproxies.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (`proxies` የፈቃድ ወሰን ያለው ቁልፍ)። [የሞባይል ፖርቶችና IP ማለዋወጥ](/am/docs/api/mobile/) ይመልከቱ።

*ቀሪ ሂሳብዎን ያረጋግጡ*

```bash
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` ይዘረዝራሉ። አዲስ ኮዶች ሊጨመሩ ይችላሉ፤ የማያውቋቸውን ኮዶች እንደ አጠቃላይ አለመሳካት ያስተናግዱ።

*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"
  }
}
```

### የሁኔታ ኮዶች

| ሁኔታ | ትርጉም |
| --- | --- |
| `422` | `validation_failed`፦ አንድ ወይም ከዚያ በላይ መስኮች ልክ አይደሉም። |
| `401` | `unauthorized`፦ ቶከን የለም፣ ልክ አይደለም ወይም ጊዜው አልፏል። |
| `402` | `insufficient_balance`፦ ቀሪ ሂሳቡ ትዕዛዙን አይሸፍንም። `details` = `InsufficientBalanceDetails`። |
| `403` | `forbidden`፦ የAPI ቁልፉ አስፈላጊው ፈቃድ የለውም፣ ወይም ሂሳቡ ታግዷል። |
| `404` | `not_found`፦ ሀብቱ የለም ወይም የሌላ ሂሳብ ነው። |
| `409` | `conflict` (ወይም የበለጠ የተለየ ኮድ)፦ በአሁኑ ሁኔታ እርምጃው አይቻልም። |
| `429` | `rate_limited` ወይም `rotation_too_soon`። |

## የጥሪ ብዛት ገደቦች

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

## የAPI ማጣቀሻ

- **[ሂሳብና ቀሪ ሂሳብ](/am/docs/api/account/)** — የሂሳብዎን ቅንብሮች፣ በቅድሚያ የተከፈለ USD ቀሪ ሂሳብና እያንዳንዱን የቀሪ ሂሳብ እንቅስቃሴ ያንብቡ (መሙያዎች፣ ግዢዎች፣ ተመላሾች)።
- **[የክሪፕቶ ሂሳብ መሙያዎች](/am/docs/api/top-ups/)** — ቀሪ ሂሳቡን በክሪፕቶ ይሙሉ፦ የመሙያ አድራሻውንና ትክክለኛውን መጠን ያግኙ፣ ያንኑ መጠን ይላኩ፣ ክፍያ መላኩን ያሳውቁ (የግብይት ID አማራጭ ነው)፣ ከዚያ ቀሪ ሂሳቡ እስኪጨመር ድረስ መሙያውን ይከታተሉ። ቀሪ ሂሳቡ ከእቅዶቻችን ለማንኛውም ይከፍላል።
- **[ትዕዛዞች](/am/docs/api/orders/)** — እቅዶችንና ዋጋዎቻቸውን ይዘርዝሩ፣ ከቀሪ ሂሳብ እቅድ ይግዙ (አዲስ አገልግሎት፣ ተጨማሪ ትራፊክ ወይም የፖርት ጊዜ ማራዘም)፣ የቀድሞ ትዕዛዞችዎንም ያንብቡ።
- **[የመኖሪያ ኔትወርክ proxy-ዎችና የመግቢያ መረጃዎች](/am/docs/api/residential/)** — የትራፊክ ምዝገባዎችን ያስተዳድሩ (የመኖሪያ ኔትወርክና በ GB የሚከፈል የሚለዋወጥ 4G/5G)፦ የproxy መግቢያ መረጃዎች፣ የራሳቸው መግቢያና የትራፊክ ገደብ ያላቸው ንዑስ ተጠቃሚዎች፣ ዕለታዊ አጠቃቀምና በproxy ተጠቃሚ ስም ሊመርጧቸው የሚችሉ ቦታዎች።
- **[የሞባይል ፖርቶችና IP ማለዋወጥ](/am/docs/api/mobile/)** — የተወሰኑ 4G/5G ፖርቶች፦ IP አሁን ወይም በሰዓት ይቀይሩ፣ የማለዋወጫ አገናኙን ይጠቀሙ፣ ዕለታዊ ትራፊኩንም ያንብቡ።
- **[የAPI ቁልፎችና የተፈቀዱ IP ዝርዝር](/am/docs/api/api-keys/)** — ውስን የፈቃድ ወሰን ያላቸውን API ቁልፎች ይፍጠሩና ይሰርዙ፣ የተፈቀዱ IP ዝርዝርንም ያስተዳድሩ፤ እስከ 10 የምንጭ አድራሻዎች proxy-ዎችን ያለ ተጠቃሚ ስምና ይለፍ ቃል እንዲጠቀሙ ይፈቀዳል።

> **ከስክሪፕት መክፈል** እቅዶች ሁልጊዜ ከበቅድሚያ የተከፈለ USD ቀሪ ሂሳብ ይከፈላሉ። በ POST /v1/topups በክሪፕቶ ይሙሉ (ዝቅተኛው US$25)፣ ከዚያ በ POST /v1/orders ይግዙ። ሁለቱም በአንድ ጥሪ ሊደረጉ ይችላሉ፤ መሙያ ትዕዛዙን በ purchase ሊይዝ ይችላል፣ መሙያው ወደ ሂሳብ እንደተጨመረም እቅዱ ይገዛል።

---

AfricaProxies: AfricaProxies በሰሃራ በታች ላለው አፍሪካ የመኖሪያ IP proxy አቅራቢ ነው፤ ክፍያው በክሪፕቶ ነው፣ መታወቂያ መጫን አያስፈልግም።