Dokumentation

Bearbejde fejl uden at miste forespørgsels konteksten.

{
  "text": "Kompleks kildeindhold på det valgte sprog.",
  "locale": "da",
  "mode": "simple-language"
}

Eksempler på SDK og cURL tilgængelige

Fejlover

Version 2 produktionsfejlkonvolutten indeholder et fejlobjekt med stabil kode og meddelelsesfelter.

json
{
  "error": {
    "code": "invalid_request",
    "message": "Check the request fields."
  }
}

Det valgfrie detaljeobjekt bærer maskinlæsbar kontekst såsom retryAfterSeconds.

HTTP-svar-headere bærer godkendelse og prøv metadata igen, hvor det er relevant.

Kravet fejlkatalog

Følgende koder er den nuværende version 2-kontrakt.

HTTPKoderBetydningKunderaktion
400invalid_jsonAnmodningsteksten er ikke gyldig JSONRet JSON-kroppen
400invalid_requestEt felt mangler, ukendt eller ugyldigt, eller teksten overstiger 10.000 tegnKorriger anmodningen
400invalid_idempotency_keyEn job- eller batchanmodning har ingen gyldig Idempotency-KeySend en unik nøgle på højst 255 tegn
400invalid_webhook_endpointDet valgte webhook-slutpunkt mangler eller er inaktivtVælg et aktivt slutpunkt, eller brug polling
401invalid_api_keyBærer-tokenet mangler, er ugyldigt eller tilbagekaldtKontroller eller udskift API-nøglen
402fakturering_påkrævetFakturering skal opdateres, før behandlingen kan fortsætteOpdater fakturering i applikationen
403abonnement_påkrævetArbejdsområdet har ingen aktiv berettigelseVælg en plan eller kontakt support
403email_not_verifiedIngen ejer- eller administrator-e-mailadresse er bekræftetBekræft en kvalificeret konto-e-mail
404job_ikke_fundetJobbet eksisterer ikke, tilhører et andet arbejdsområde eller er udløbetStop afstemningen og opret et nyt job, hvis det er nødvendigt
404batch_ikke_fundetBatchen findes ikke, tilhører et andet arbejdsområde eller er udløbetStop polling og opret en ny batch, hvis det er nødvendigt
429rate_limitedAnmodningsraten er nåetRespekt efter at have prøvet igen
429concurrency_limitFor mange anmodninger behandles på samme tidPrøv igen, når en aktiv anmodning er afsluttet
429godtgørelse_opbrugtDen månedlige tegngrænse er nået, og yderligere brug er utilgængelig eller deaktiveretVent på den næste faktureringsperiode, eller aktiver yderligere brug på et kvalificeret abonnement
502process_failedTjenesten kunne ikke behandle tekstenPrøv igen sikkert, og kontakt support med anmodnings-id'et, hvis det fortsætter

For hver fejl, dokumentgentagelse, faktureringseffekt, logsynlighed og supportoplysninger.