Erori
Orice eroare are aceeași formă. message vine în limba cerută cu lang, iar docs duce la explicația de mai jos. O eroare nu costă credite.
Forma unei erori
{
"error": {
"code": "quota_exceeded",
"message": "Ai folosit toate creditele perioadei.",
"docs": "https://developer.satelit.md/en/errors/#quota_exceeded"
}
}401auth_required
Când apare: Apelul nu are nicio cheie.
Ce faci: Trimite Authorization: Bearer sat_live_… sau X-Api-Key.
401key_invalid
Când apare: Cheia este necunoscută sau a fost revocată. După 30 de încercări greșite pe minut, de pe același IP, răspunsul devine 429.
Ce faci: Verifică cheia în panou. Dacă e revocată, creează alta.
402plan_required
Când apare: Contul nu are un plan, sau planul tău nu are acest lucru: webhooks, flux, export. Câmpul choose duce la pagina de prețuri.
Ce faci: Alege un plan pe pagina de prețuri și cere-l din panou. Un apel refuzat nu costă nimic.
403not_available
Când apare: Sursele acestui produs nu sunt disponibile acum în API.
Ce faci: Vezi pagina de stare sau scrie-ne la hello@satelit.md.
403account_suspended
Când apare: Contul a fost suspendat de un administrator.
Ce faci: Scrie-ne la hello@satelit.md.
404not_found
Când apare: Ruta sau rândul nu există.
Ce faci: Verifică adresa și identificatorul în referință.
405method_not_allowed
Când apare: Ai folosit altă metodă decât GET, HEAD sau OPTIONS.
Ce faci: Folosește GET. API-ul doar citește.
422invalid
Când apare: Un parametru este greșit. Câmpul fields spune care.
Ce faci: Corectează parametrii din fields. Formatele sunt în referință.
429rate_limited
Când apare: Ai depășit limita pe minut a planului.
Ce faci: Așteaptă câte secunde spune Retry-After și reia apelul.
429quota_exceeded
Când apare: Ai folosit toate creditele perioadei.
Ce faci: Așteaptă resetarea din X-Credits-Reset sau cere un plan mai mare. Nu se facturează nimic în plus.
503busy
Când apare: Serviciul are prea multe răspunsuri în lucru sau baza de date nu răspunde.
Ce faci: Așteaptă câte secunde spune Retry-After și reia apelul.