# API v2 fel och försök igen

> Hantera GenderAPI v2 Problem Details, valideringsfel, räntegränser och faktureringsosäkerhet. Förstå omkostnader och när du ska kontakta support.

Canonical HTML: https://www.genderapi.io/sv/docs/v2/errors-and-retries

Last reviewed: 2026-09-25

## Fel och HTTP statuskoder

Applikationsfel använder application/problem+json (RFC 9457). Hantera fel med de stabila fälten code och action, snarare än den förklarande texten i detail. För valideringsfel innehåller errors JSON Pointer-platser för de berörda fälten. Inkludera request_id när du kontaktar support. Proxy- eller anslutningsfel kan returnera ett annat svarsorgan; kontrollera Content-Type innan du analyserar JSON.

Följande syntetiska 422 exempel visar ogiltig e-postsyntax före fakturering. Den offentliga felkatalogen listar varje kod, status, förklaring och föreslagen åtgärd.

| HTTP status | Typisk betydelse | Nästa steg |
| --- | --- | --- |
| 400 / 413 / 415 | Felaktig JSON, överdimensionerad kropp eller mediatyp som inte stöds. | Rätta begäran. |
| 401 / 403 | Åtkomst avvisad, kontobegränsning eller otillräcklig kredit. | Inspektera code; rätt åtkomst eller fyll på krediter / vänta på provåterställning. |
| 422 | Ogiltig inmatning eller inkompatibla alternativ. | Korrigera fälten identifierade i errors. |
| 404 / 405 | Okänd rutt eller HTTP-metod som inte stöds. | Kontrollera ändpunktsvägen och Allow-svarshuvudet. |
| 429 | Takst- eller samtidighetsgräns. | Vänta på Retry-After innan du skickar en ny förfrågan. |
| 500 | Oväntat serverfel. | Kontakta support med request_id; kontrollera faktureringen innan du försöker igen. |
| 502 / 503 / 504 | Leverantör, beroende, fakturering eller timeoutfel. | Inspektera code, action och billing_status innan du försöker igen. |

```json
{
  "type": "urn:genderapi:problem:validation_error",
  "title": "validation error",
  "status": 422,
  "detail": "A valid email address is required.",
  "instance": "urn:uuid:11111111-1111-4111-8111-111111111111",
  "code": "validation_error",
  "request_id": "11111111-1111-4111-8111-111111111111",
  "documentation": "https://api.genderapi.io/api/v2/errors",
  "action": "correct_request",
  "errors": [
    {
      "pointer": "/value",
      "message": "Invalid email address."
    }
  ],
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 0,
      "remaining_credits": null,
      "billing_status": "not_charged",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

- [Fullständig v2-felkatalog](https://api.genderapi.io/api/v2/errors)

## Försök igen och fakturering

Varje prediktionsbegäran är en ny operation, inklusive en identisk begäran som skickas igen. Normala kreditregler gäller för varje begäran. Det finns inget skydd för dubbletter av begäran, så undvik automatiska återförsök efter en anslutningsbortfall eller ett okänt resultat.

För ett 429-svar, vänta på Retry-After innan du skickar en ny förfrågan. För prediktionsfel, inspektera code, action och meta.usage.billing_status först. För billing_reconciliation_required eller obekräftad fakturering, kontakta supporten med request_id innan du försöker igen.

En partiellt lyckad batch kan returnera HTTP 200. Kontrollera varje artikel och skicka endast in misslyckade artiklar efter att faktureringen har bekräftats; framgångsrika varor faktureras igen om de skickas in igen.

X-Request-ID och meta.request_id identifierar det aktuella HTTP-försöket. Läs /usage för aktuellt saldo. HEAD startar inte en fakturerbar förutsägelse. Förutsägelse och kontosvar är inte cachebara.

Klienter bör tolerera additiva svarsfält och bevara null-värden när information inte är tillgänglig.

## Begäran gränser

Hantera HTTP 429 och Retry-After istället för att anta att förfrågningar alltid kommer att accepteras vid dessa tak. Servicekapaciteten är delad. Värdena som visas är de nuvarande standardinställningarna för tjänsten. Frekvensgränssvar inkluderar X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset (Unix sekunder). Retry-After är en fördröjning i sekunder. Dessa rubriker beskriver begärandegränser, inte återstående krediter. Även den kostnadsfria /usage-läsningen räknas mot hastighetsgränserna.

| Gräns | Värde |
| --- | --- |
| JSON begäran kropp | 64 KiB max |
| Prediktionsvärde | 1–254 tecken |
| Batch | 50 artiklar med en API-nyckel; 10 med IP testversionen |
| Kontotaxa | 120 förfrågningar per minut |
| IP hastighet | 600 förfrågningar per minut |
| Samtidiga operationer | 2 per konto; 16 över tjänsten |