LocalSERP Proxy API-Dokumentation

Authentifizierung

Jede Anfrage außer dem öffentlichen Katalog erfordert einen API-Schlüssel: Authorization: Bearer API_KEY. Ein Schlüssel wird bei der Erstellung einmal vollständig angezeigt: Bewahre ihn wie ein Passwort auf. Du kannst einen Schlüssel jederzeit widerrufen; Anfragen mit diesem Schlüssel geben dann 401 unauthorized zurück.

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

Anfragen und Antworten

• JSON rein, JSON raus: Sende Content-Type: application/json mit einem Body.
• Listen, die wachsen können, sind mit page (ab 1) und perPage (1–100, Standardwert 20) paginiert und geben { "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } } zurück. Kurze Listen geben { "data": [...] } zurück.
• IDs sind undurchsichtige Zeichenfolgen mit einem Typpräfix: ord_ (Bestellung), top_ (Aufladung), txn_ (Guthabenbewegung), res_ (Traffic-Abo), mob_ (mobiler Port), key_ (API-Schlüssel) und ipw_ (IP-Allowlist-Eintrag).
• Sichere Wiederholungen: POST /v1/orders und POST /v1/topups akzeptieren einen Idempotency-Key-Header (beliebige eindeutige Zeichenfolge, 24 h gespeichert). Bei erneuter Verwendung desselben Schlüssels wird die erste Antwort zurückgegeben, statt erneut zu kaufen oder aufzuladen.
• Beispiele zeigen den Aufbau jeder Antwort: Die darin enthaltenen IDs, IPs, Beträge und Daten dienen nur der Veranschaulichung; die Plan-IDs und Preise sind echt.

Fehler

Alle Fehler haben denselben Body. code ist stabil und für deinen Code vorgesehen; message ist ein englischer Satz, der sich ändern kann. Validierungsfehler führen jedes ungültige Feld in fields auf. Es können neue Codes hinzukommen: Behandle unbekannte Codes als allgemeinen Fehler.

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

Ratenbegrenzungen

Jede Antwort enthält RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. Bei Überschreitung des Limits antwortet die API mit 429 rate_limited und einem Retry-After-Header (Sekunden): Warte so lange und versuche es dann erneut. Die IP eines mobilen Ports kann höchstens alle 30 Sekunden geändert werden (429 rotation_too_soon, mit Retry-After).