Minden hiba az RFC 7807 szabványt követi. A törzs application/problem+json a type, title, status, detail, request_id és opcionálisan reason vagy errors[] mezőkkel.
{
"type": "https://www.kernelhost.com/en/reseller-api/errors/payment_required",
"title": "Payment required",
"status": 402,
"detail": "The order could not be paid.",
"request_id": "01HX7Z3K8Q...",
"reason": "insufficient_credit_and_no_card"
}| HTTP | type | Jelentés |
|---|---|---|
| 400 | validation_failed | A bemeneti ellenőrzés sikertelen. Mezőnkénti részletekért lásd az errors[] tömböt. |
| 401 | auth_failed | A hitelesítés sikertelen. A reason jelzi az okot: missing_headers, bad_key, bad_timestamp, timestamp_out_of_window, bad_nonce, bad_signature, signature_mismatch, replay_detected, unknown_or_locked_key, ip_not_allowed. |
| 402 | payment_required | Fizetés szükséges. A reason lentebb látható. |
| 403 | forbidden_scope | Hiányzó jogosultság. reason: missing_scope. |
| 404 | not_found | Az erőforrás nem létezik vagy nem látható ennek a kulcsnak (megakadályozza a bérlők felderítését). |
| 409 | idempotency_conflict | Az Idempotency-Key már használatban volt eltérő törzzsel. |
| 429 | rate_limited | Sebességkorlát túllépve. Tartsa be a Retry-After fejlécet. |
| 500 | internal_error | Belső szerverhiba. Adja meg a request_id azonosítót az audit-naplóval való összevetéshez, amikor a támogatáshoz fordul. |
Fizetés-szükséges indoklások (HTTP 402)
Ha a megrendelést nem lehet kifizetni, az API HTTP 402 választ ad gépi olvasásra alkalmas reason mezővel a JSON-törzsben.
insufficient_credit_and_no_card(Nincs elegendő egyenleg és nincs eltárolt kártya. Megoldás: töltse fel egyenlegét vagy adjon hozzá kártyát az ügyfélportálon.)card_declined(A bank vagy az átjáró elutasította a kártyát. Megoldás: próbáljon másik kártyát vagy lépjen kapcsolatba bankjával.)card_expired(Lejárt kártya. Megoldás: adjon hozzá új kártyát az ügyfélportálon.)client_not_found(A fiókazonosító nem található (gyakorlatilag soha nem fordulhat elő, lépjen kapcsolatba a támogatással).)
