Feil

Feil bruker vanlige HTTP-statuskoder og en JSON-body med en lesbar detail og en maskinlesbar code. Bruk code i integrasjonen din, siden ordlyden i detail kan endres.

Feilformat

Feil som ikke gjelder ett bestemt felt:

{ "detail": "Invalid API key.", "code": "authentication_failed" }

Valideringsfeil har én oppføring per felt som feilet:

{
  "country": { "detail": "\"Sweden\" is not a valid choice.", "code": "invalid_choice" },
  "portfolio_id": { "detail": "Invalid pk \"...\" - object does not exist.", "code": "does_not_exist" }
}

Et felt med flere problemer har en liste med { "detail", "code" }-objekter i stedet for ett enkelt.

Feilmeldingene i detail er vanligvis på engelsk.

Statuskoder

Status	Kode	Når
400 Bad Request	per felt	En filterverdi eller et felt i forespørselen er ugyldig.
401 Unauthorized	authentication_failed	API-nøkkelen mangler, er feil, er rotert eller tilbakekalt, eller brukeren er deaktivert.
403 Forbidden	external_api_create_not_allowed	Du prøvde å opprette en eiendom, men oppretting er ikke slått på for organisasjonen din.
404 Not Found	not_found	Det finnes ingen mappe eller eiendom med denne ID-en i organisasjonen din.
405 Method Not Allowed	method_not_allowed	Endepunktet støtter ikke denne metoden, for eksempel DELETE.
500 Internal Server Error		Noe gikk galt hos Telescope. Telescope varsles automatisk. Prøv igjen senere.

En 404 sier ikke om ID-en finnes i en annen organisasjon. For nøkkelen din finnes ikke andre organisasjoners data.

Vanlige valideringsfeil

Filtre på eiendomslisten:

{ "hazard": { "detail": "Select a valid choice. flood is not one of the available choices.", "code": "invalid_choice" } }

Filterverdier skiller mellom store og små bokstaver, og det kan ikke være mellomrom etter kommaene. Se tillatte verdier.

Oppretting av eiendom: se feiltabellen i Opprett eiendommer.

Nye forsøk

• Prøv 500 og nettverksfeil på nytt, med stadig lengre ventetid.
• Ikke prøv 400, 401, 403 eller 404 på nytt uten endringer. Rett opp forespørselen eller nøkkelen først.
• Når du prøver en oppretting på nytt, send med internal_reference_id. Da blir en forespørsel som faktisk lyktes før tilkoblingen brøt, til en oppdatering av eiendommen i stedet for at det opprettes en ny.