Fehler | Proxynet Docs

Fehlerformat

{
  "error": {
    "code": "not_found",
    "message": "Order not found.",
    "request_id": "83955522c09ff2d1"
  }
}

Auch ein undefinierter Pfad liefert im selben Format JSON 404 not_found; eine HTML-Seite kommt nicht zurück.

Codes

HTTP	code	Wann
401	`unauthorized`	Token fehlt, hat ein fehlerhaftes Format oder ist ungültig.
403	`insufficient_scope`	Dem Token fehlt die Berechtigung, die dieser Endpoint verlangt.
403	`tier_required`	Die gewünschte Funktion ist in Ihrer Stufe nicht enthalten (z. B. einen eigenen Benutzernamen wählen).
403	`forbidden`	Dieser Vorgang ist nicht erlaubt.
404	`not_found`	Ressource nicht gefunden oder ausgeblendet, weil sie abgelaufen ist.
404	`api_disabled`	Der API-Zugriff ist deaktiviert.
405	`method_not_allowed`	Dieser Endpoint unterstützt diese HTTP-Methode nicht. Die unterstützten Methoden stehen im Allow-Header.
400	`invalid_request`	Ungültiges Feld, unbekanntes Feld oder unbekannter Parameter, Feld eines anderen Typs.
402	`insufficient_balance`	Das Guthaben reicht für diesen Vorgang nicht aus.
409	`conflict`	Statuskonflikt: nicht verlängerbarer Dienst, idempotente Anfrage in Bearbeitung, Benutzername bereits vergeben.
429	`rate_limited`	Rate Limit überschritten.
502 / 503	`service_unavailable`	Anbieter oder Log-Speicher nicht erreichbar; versuchen Sie es erneut.
500 / 502	`internal_error`	Unerwarteter Fehler; wenden Sie sich mit der request_id an den Support.

details

Gibt es zu einem Fehler maschinenlesbare Details, stehen sie im Feld details: etwa das fehlerhafte Feld (field), der Bestand (available), die Mindestmenge (min_required), das Guthaben (balance), der erlaubte Höchstwert (max) oder der Grund des Fehlers (reason). Ist ein Diensttyp zum Beispiel in Wartung, kommt mit service_unavailable auch reason: maintenance.

402 insufficient_balance

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance for this operation.",
    "request_id": "5f1c0a9e7b2d4c61",
    "details": { "field": "balance", "balance": 3.2, "min_required": 12.5 }
  }
}

request_id

Loggen Sie den Wert request_id; das Support-Team kann damit im Serverprotokoll suchen.