# AfricaProxies-API-Dokumentation

> AfricaProxies-REST-API auf africaproxies.com/api: API-Schlüssel, Fehler, Limits und Endpunkte für Guthaben, Krypto, Bestellungen, Proxys und mobile IP-Rotation.

- URL: https://africaproxies.com/de/docs/api/
- Zuletzt aktualisiert: 2026-10-15
- Herausgeber: AfricaProxies (https://africaproxies.com)

Alles in deinem Konto lässt sich skripten: Guthaben prüfen, mit Krypto aufladen, Tarif kaufen, Proxy-Zugangsdaten erstellen und eine mobile IP rotieren. JSON über HTTPS, ein API-Schlüssel, Beispiele in curl, Python und Node.js.

**Schnelle Antwort — Wie nutze ich die API von AfricaProxies?**

Sende HTTPS-Anfragen an `https://africaproxies.com/api/v1` mit deinem API-Schlüssel im Header `Authorization: Bearer API_KEY`. Erstelle den Schlüssel auf der [Entwicklerseite](/app/developer?lang=de) deines Kontos (oder mit `POST /v1/api-keys`) und gib ihm nur die benötigten Berechtigungen. Anfragen und Antworten sind JSON; Fehler kommen immer als `{ "error": { "code", "message" } }` zurück.

## Auf einen Blick

| Attribut | Wert |
| --- | --- |
| Basis-URL | `https://africaproxies.com/api/v1` |
| Format | JSON über HTTPS, UTF-8 |
| Authentifizierung | API-Schlüssel: `Authorization: Bearer API_KEY` |
| Berechtigungsumfänge des API-Schlüssels | `read`, `proxies`, `billing` |
| Geldbeträge | USD als Zeichenfolge mit 2 Nachkommastellen (`"29.00"`) |
| Kryptobeträge | Dezimalzahlen als Zeichenfolgen, nie Gleitkommazahlen (`"0.00045210"`) |
| Datenvolumen | Bytes (1 GB = 1,000,000,000 Bytes) |
| Datumsangaben | ISO 8601 in UTC (`2026-10-05T14:03:11Z`) |
| Version | `/v1` in jedem Pfad |

## Authentifizierung

Jede Anfrage außer dem öffentlichen Katalog enthält einen API-Schlüssel: `Authorization: Bearer API_KEY`. Ein Schlüssel wird nur **einmal** vollständig angezeigt, bei seiner Erstellung: Speichere ihn wie ein Passwort. Du kannst ihn jederzeit widerrufen; Anfragen damit geben dann `401 unauthorized` zurück.

### Berechtigungsumfänge

Gib jedem Schlüssel nur die Rechte, die dein Skript benötigt. Ohne erforderlichen Berechtigungsumfang erhält er `403 forbidden`.

| Berechtigungsumfang | Erlaubte Aktionen |
| --- | --- |
| `read` | alles lesen (Konto, Guthaben, Dienste, Nutzung). |
| `proxies` | Proxy-Einstellungen und Zugangsdaten ändern (Bezeichnungen, automatische Verlängerung, neue Passwörter), Unterbenutzer und die IP-Freigabeliste verwalten sowie mobile Ports rotieren (einschließlich Rotationslink). |
| `billing` | Bestellungen und Aufladungen erstellen, mit Guthaben bezahlen. |

Einzige Ausnahme ist der **mobile Rotationslink** für Browser-Lesezeichen oder ein einfaches `curl`: `GET https://africaproxies.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (Schlüssel mit Berechtigung `proxies`). Siehe [Mobile Ports und IP-Rotation](/de/docs/api/mobile/).

*Guthaben prüfen*

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

## Anfragen und Antworten

- **JSON rein, JSON raus**: Sende `Content-Type: application/json` bei einem Body.
- **Listen**, die wachsen können, werden mit `page` (ab 1) und `perPage` (1–100, Standard 20) paginiert und geben `{ "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } }` zurück. Kurze Listen geben `{ "data": [...] }` zurück.
- **IDs** sind Zeichenfolgen ohne auszuwertende Struktur mit Typpräfix: `ord_` (Bestellung), `top_` (Aufladung), `txn_` (Kontobewegung), `res_` (Datenabo), `mob_` (mobiler Port), `key_` (API-Schlüssel) und `ipw_` (Eintrag der IP-Freigabeliste).
- **Sichere Wiederholungen**: `POST /v1/orders` und `POST /v1/topups` akzeptieren einen `Idempotency-Key`-Header (beliebige eindeutige Zeichenfolge, 24 h gespeichert). Dieselbe Kennung liefert erneut die erste Antwort, statt doppelt zu kaufen oder aufzuladen.
- **Beispiele** zeigen die Antwortstruktur: IDs, Adressen, Beträge und Daten sind illustrativ, Tarif-IDs und Preise sind echt.

## Fehler

Jeder Fehler hat dieselbe Body-Struktur. `code` ist stabil und für deinen Code gedacht; `message` ist ein englischer Satz, der sich ändern kann. Validierungsfehler nennen jedes ungültige Feld in `fields`. Neue Codes können hinzukommen: Behandle unbekannte Codes als allgemeinen Fehler.

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

### Statuscodes

| Status | Bedeutung |
| --- | --- |
| `422` | `validation_failed`: Mindestens ein Feld ist ungültig. |
| `401` | `unauthorized`: Token fehlt, ist ungültig oder abgelaufen. |
| `402` | `insufficient_balance`: Das Guthaben deckt die Bestellung nicht ab. `details` = `InsufficientBalanceDetails`. |
| `403` | `forbidden`: Dem API-Schlüssel fehlt der erforderliche Berechtigungsumfang, oder das Konto ist gesperrt. |
| `404` | `not_found`: Ressource existiert nicht oder gehört zu einem anderen Konto. |
| `409` | `conflict` (oder genauerer Code): Die Aktion ist im aktuellen Zustand nicht möglich. |
| `429` | `rate_limited` oder `rotation_too_soon`. |

## Anfragelimits

Jede Antwort enthält `RateLimit-Limit`, `RateLimit-Remaining` und `RateLimit-Reset`. Über dem Limit antwortet die API mit `429 rate_limited` und einem `Retry-After`-Header (Sekunden): Warte so lange und versuche es erneut. Die IP eines mobilen Ports lässt sich höchstens einmal alle 30 Sekunden ändern (`429 rotation_too_soon`, mit `Retry-After`).

## API-Referenz

- **[Konto und Guthaben](/de/docs/api/account/)** — Lies deine Kontoeinstellungen, dein vorausbezahltes USD-Guthaben und jede Kontobewegung (Aufladungen, Käufe, Erstattungen).
- **[Krypto-Aufladungen](/de/docs/api/top-ups/)** — Lade Guthaben mit Krypto auf: Rufe Einzahlungsadresse und exakten Betrag ab, sende genau diesen Betrag, melde die Zahlung als gesendet (Transaktions-ID optional) und verfolge die Aufladung bis zur Gutschrift. Das Guthaben bezahlt jeden unserer Tarife.
- **[Bestellungen](/de/docs/api/orders/)** — Tarife und Preise auflisten, einen Tarif mit Guthaben kaufen (neuer Dienst, mehr Datenvolumen oder Port-Verlängerung) und bisherige Bestellungen lesen.
- **[Residential-Proxys und Zugangsdaten](/de/docs/api/residential/)** — Datenabos verwalten (Residential sowie rotierendes 4G/5G pro GB): Proxy-Zugangsdaten, Unterbenutzer mit eigenen Zugangsdaten und Datenlimit, Tagesverbrauch sowie Standorte für die Auswahl im Proxy-Benutzernamen.
- **[Mobile Ports und IP-Rotation](/de/docs/api/mobile/)** — Dedizierte 4G/5G-Ports: IP sofort oder per Timer ändern, Rotationslink verwenden und Tagesverbrauch lesen.
- **[API-Schlüssel und IP-Freigabeliste](/de/docs/api/api-keys/)** — API-Schlüssel mit begrenztem Berechtigungsumfang erstellen und widerrufen sowie die IP-Freigabeliste verwalten: bis zu 10 Quelladressen dürfen die Proxys ohne Benutzername und Passwort nutzen.

> **Zahlung per Skript** Tarife werden immer aus dem vorausbezahlten USD-Guthaben bezahlt. Lade mit Krypto auf (mindestens 25 $), über POST /v1/topups, und kaufe dann über POST /v1/orders. Beides geht mit einem Aufruf: Eine Aufladung kann die Bestellung in purchase enthalten; der Tarif wird gekauft, sobald die Aufladung gutgeschrieben wird.

---

AfricaProxies: AfricaProxies ist ein Anbieter von Residential Proxys für Subsahara-Afrika, mit Kryptozahlung und ohne Hochladen eines Ausweises.