Felhantering

Meirras API använder gängse HTTP-statuskoder för att signalera om förfrågningar lyckades eller misslyckades. Allmänt: • **2xx** – Lyckades. Förfrågan fungerade som förväntat. • **4xx** – Klientfel. Förfrågan var ogiltig eller kunde inte servas. • **5xx** – Serverfel. Något gick fel hos oss. Alla felsvar har en konsekvent JSON-struktur med felkod, meddelande och relevanta detaljer som hjälper dig att diagnostisera och hantera problemet.

Alla fel följer ett konsekvent format: ```json { "success": false, "error": { "code": "ERROR_CODE", "message": "Läsbar felbeskrivning", "details": { ... } } } ``` Fältet `code` är en maskinläsbar felkod som du kan använda i din felhanteringslogik. `message` ger en beskrivning för människor. Det valfria `details`-objektet ger ytterligare kontext kopplad till feltypen.

Autentiseringsfel inträffar när din API-nyckel saknas, är ogiltig eller saknar behörighet. | Kod | HTTP | Beskrivning | |-----|------|-------------| | `INVALID_API_KEY` | 401 | API-nyckel saknas eller är ogiltig | | `API_KEY_REVOKED` | 401 | API-nyckel har återkallats | | `IP_NOT_ALLOWED` | 403 | Förfrågans IP saknas i allowlisten | **Exempel:** ```json { "success": false, "error": { "code": "INVALID_API_KEY", "message": "Den angivna API-nyckeln är ogiltig eller saknas" } } ``` **Så åtgärdar du:** Kontrollera att API-nyckeln är korrekt och skickas i headern `x-api-key`. Kolla i Developer Dashboard om nyckeln har återkallats.

Saldofel inträffar när ditt konto saknar tillräckligt med krediter för förfrågan. | Kod | HTTP | Beskrivning | |-----|------|-------------| | `INSUFFICIENT_BALANCE` | 402 | För lågt saldo för förfrågan | **Exempel:** ```json { "success": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "Ditt saldo på $0.50 räcker inte för denna förfrågan ($1.00 krävs)", "details": { "balanceRemaining": 0.50, "costRequired": 1.00 } } } ``` **Så åtgärdar du:** Fyll på saldot i Developer Dashboard. Överväg att aktivera varningar för lågt saldo för att undvika avbrott.

Rate limit-fel inträffar när du överskrider den tillåtna förfrågningstakten. | Kod | HTTP | Beskrivning | |-----|------|-------------| | `RATE_LIMIT_EXCEEDED` | 429 | För många förfrågningar | **Exempel:** ```json { "success": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit överskridet. Försök igen om 60 sekunder.", "details": { "limit": 1000, "remaining": 0, "resetAt": "2026-02-27T15:30:00Z", "retryAfter": 60 } } } ``` **Så åtgärdar du:** Implementera exponentiell backoff. Läs `Retry-After`-headern för att veta när du kan försöka igen. Sprid ut förfrågningarna över tid.

Valideringsfel inträffar när parametrar i förfrågan saknas eller är ogiltiga. | Kod | HTTP | Beskrivning | |-----|------|-------------| | `INVALID_REQUEST` | 400 | Parametrar saknas eller är ogiltiga | | `INVALID_EMAIL` | 400 | E-postformatet är ogiltigt | | `BATCH_TOO_LARGE` | 400 | Batchen överskrider maxstorleken | **Exempel:** ```json { "success": false, "error": { "code": "INVALID_REQUEST", "message": "Validering av förfrågan misslyckades", "details": { "field": "email", "issue": "E-post krävs" } } } ``` **Så åtgärdar du:** Kontrollera fältet `details` för att se exakt vilket valideringsfel som uppstod. Säkerställ att alla obligatoriska fält finns med i förväntat format.

Tjänstefel inträffar när något går fel i vår infrastruktur. | Kod | HTTP | Beskrivning | |-----|------|-------------| | `SERVICE_ERROR` | 500 | Internt tjänstefel | | `SERVICE_UNAVAILABLE` | 503 | Tjänsten tillfälligt otillgänglig | | `UPSTREAM_ERROR` | 502 | Extern beroende-tjänst misslyckades | **Exempel:** ```json { "success": false, "error": { "code": "SERVICE_ERROR", "message": "Ett internt fel uppstod. Försök igen senare." } } ``` **Så åtgärdar du:** Detta är tillfälliga fel. Implementera retry-logik med exponentiell backoff. Om felen kvarstår, kolla statussidan eller kontakta support.