Felkoder

Fel svarar med en HTTP-status och en kropp i formatet application/problem+json (RFC 9457). Låt programmet läsa code; title och detail är skrivna för människor och kan ändras.

Varje svar har headern X-Request-Id, samma som request_id i felet. Ange den om du kontaktar oss på support@qrona.se.

Exempel

{
  "type": "https://newsletter.qrona.se/developer/api/errors#validation_failed",
  "title": "Uppgifterna stämmer inte",
  "status": 422,
  "code": "validation_failed",
  "request_id": "6c0e1f5a-2b8d-4e3f-9a71-0c5d2e8b4f19",
  "errors": [
    {
      "field": "consent_source",
      "message": "Beskriv hur personen har samtyckt."
    }
  ]
}

400: bad_request; Förfrågan kunde inte läsas. Kroppen är inte giltig JSON, eller för stor.
401: unauthenticated; API-nyckel saknas. Ingen Authorization: Bearer-header.
401: invalid_key; Okänd API-nyckel. Nyckeln finns inte (felstavad, eller från en annan miljö).
401: key_revoked; API-nyckeln är återkallad. En administratör har återkallat nyckeln.
401: key_expired; API-nyckeln har gått ut. Nyckelns giltighetstid är slut.
401: key_inactive; API-nyckeln gäller inte längre. Personen som skapade nyckeln har inte längre åtkomst till arbetsytan, eller arbetsytan är stängd.
402: payment_required; Abonnemang krävs. Provperioden är slut och ingen betalning är vald.
403: insufficient_scope; Nyckeln saknar behörighet. Nyckeln har inte den behörighet (scope) som anropet kräver.
403: forbidden; Inte tillåtet. Personen bakom nyckeln har inte den roll som krävs, eller kontakten ligger utanför det personen får se.
403: shared_contact; Kontakten är delad. Kontakten är delad från en nivå ovanför och kan bara ändras där.
403: workspace_suspended; Arbetsytan är pausad. Qrona har pausat arbetsytan.
404: not_found; Finns inte. Resursen finns inte, eller ligger utanför det nyckeln får se.
409: contact_exists; Kontakten finns redan. Det finns redan en kontakt med adressen. Använd /contacts/upsert för att skapa eller uppdatera.
409: contact_erased; Kontakten är raderad. Kontakten har raderats (GDPR) och kan inte ändras eller läggas till igen.
409: suppressed; Adressen är spärrad. Adressen finns i spärrlistan.
409: blocked; Adressen tar inte emot utskick. Adressen studsar, har anmält skräppost, är raderad eller spärrad.
409: opted_out; Personen har avregistrerat sig. Bara personen själv kan anmäla sig igen.
409: sending_not_enabled; Utskick är inte godkända. Arbetsytan är inte godkänd för utskick än, så inget bekräftelsemejl kan skickas.
409: list_in_use; Listan används. En kampanj som ska skickas använder listan.
409: limit_reached; Taket är nått. Arbetsytan har redan så många butiker eller webhooks som går.
409: idempotency_in_progress; Anropet pågår redan. Ett anrop med samma Idempotency-Key körs fortfarande. Vänta en stund och skicka igen.
409: idempotency_conflict; idempotency_key används redan. Meddelandets idempotency_key har redan använts för ett meddelande med annat innehåll. Samma innehåll igen ger det första meddelandet.
409: template_not_published; Mallen är inte publicerad. Det finns en Qrona-mall med nyckeln, men ingen publicerad version att göra meddelanden av.
409: sender_not_configured; Avsändare saknas. Tillägget har ingen verifierad avsändare. En administratör väljer den under Inställningar → Tillägg.
415: unsupported_media_type; Fel innehållstyp. Kroppen måste skickas som application/json.
422: validation_failed; Uppgifterna stämmer inte. Ett eller flera fält är fel. Se errors[].
422: idempotency_key_reused; Idempotency-Key används redan. Nyckeln har redan använts för ett annat anrop (annan sökväg eller kropp) de senaste 24 timmarna. Använd en ny nyckel för varje nytt anrop.
429: rate_limited; För många anrop. Nyckeln har gjort för många anrop. Vänta det antal sekunder som Retry-After säger.
500: internal_error; Något gick fel hos oss. Försök igen. Hänvisa till request_id om det fortsätter.