Developer docsInformational
Erori HTTP Router by MP
401, 403, 429, 5xx — ce înseamnă și cum le gestionezi.
Raspuns scurt
Erori standard: 401 (cheia lipsa/invalida), 403 (model nepermis sau buget exceeded), 429 (rate limit), 5xx (upstream issue). Toate au mesaj structurat in body.
Problema concreta
Echipele cer un manual clar pentru a gestiona erorile in productie.
Cum o rezolva Router by MP
Tabel erori cu cauza și actiune. Patterns retry-backoff pentru 429 și 5xx. Logare structurata pentru audit.
Fluxuri uzuale
- 401: verifica cheia in cabinet.
- 403: verifica whitelist model și buget.
- 429: retry exponential backoff.
- 5xx: retry și dacă persista, fallback model.
| Control | De ce conteaza |
|---|---|
| Mesaj structurat | Body contine cod și descriere. |
| Cabinet | Audit log arată cauza exacta. |
| Fallback | Configurabil per cheie pentru 5xx. |
Eroare 403 samplejson
{
"error": {
"code": "model_not_allowed",
"message": "Model 'gpt-5.4-pro' not in whitelist for this key.",
"type": "permission_error"
}
}Reguli si limite
- Retry agresiv. Nu retry la 401/403; verifica configul intai.
- 5xx vs 429. 5xx = upstream; 429 = limit; comportament diferit.
- Timeout. Pentru request lung, mareste timeout client.
Integrare rapida
Foloseste endpointul https://api.megapromoting.com/v1, trimite cheia caAuthorization: Bearer <router_api_key> si verifica pagina/modelsinainte de productie.