Fejlfinding af Pleo API-fejl

Anmodningen er ugyldig eller består ikke valideringen.

• Læs svarindholdet for at identificere manglende felter eller ugyldige værdier.
• Sammenlign din anmodning med endpoint-dokumentationen. Tjek de påkrævede felter, anmodningsstrukturen, datoformaterne og de tilladte værdier.
• Ret det identificerede problem, og prøv anmodningen igen.

Anmodningen kunne ikke godkendes.

• Match loginoplysningerne med API'en og miljøet. Tjek anmodningens host i forhold til udviklerdokumentationen. Bland ikke loginoplysningerne til den nye og tidligere API sammen, og bland heller ikke loginoplysningerne til stadieinddelingen og produktionen sammen.
• Tjek autorisationsoverskriften ("Authorization"). Nye API-nøgler bruger grundlæggende autentificering med nøglen som brugernavn og en tom adgangskode. OAuth-adgangstokens bruger Bearer-autentificering. Følg dokumentationen til den tidligere API for tidligere tokens. Fjern utilsigtede mellemrum eller linjeskift fra loginoplysningerne.
• Tjek status for loginoplysningerne. Bekræft, at de ikke er udløbet eller tilbagekaldt. For OAuth skal du bruge adgangstokenet – ikke opdateringstokenet – og du bør kontrollere, at tokenopdateringsflowet fungerer.

Anmodningen blev godkendt, men adgang er ikke tilladt.

• Tjek omfang. Sammenlign de omfang, der er tildelt til dine loginoplysninger, med dem, der kræves af endpointet. Hvis du ikke kan se dem, skal du bede den person, der administrerer loginoplysningerne, om at bekræfte dem.
• Tjek virksomheden og miljøet. Loginoplysningerne skal stemme overens med den virksomhed eller enhed, du anmoder om data for, og det miljø, du kalder.
• Tjek endpointets tilgængelighed. Bekræft i udviklerdokumentationen, at endpointet understøtter din autentificeringsmetode og din use case.

Hvis disse stemmer overens, men adgang stadig nægtes, skal du kontakte support for at få bekræftet virksomhedens API-adgang. Angiv, om de samme loginoplysninger fungerer på andre endpoints.

Det endpoint eller den ressource, der blev anmodet om, blev ikke fundet.

• Sammenlign basis-URL-adressen, API-versionen og endpointstien med udviklerdokumentationen.
• Bekræft, at ressource-id'et identificerer den ressource, du ønskede at anmode om.
• Tjek, at ressourcen tilhører den virksomhed og det miljø, der er knyttet til loginoplysningerne. Bland ikke stadieinddelings- og produktions-id'er.

En ressource kan returnere 404, selvom den findes i Pleo, hvis den tilhører en anden virksomhed eller et andet miljø.

Anmodningen er i konflikt med en eksisterende handling eller tilstand.

• Læs fejlsvaret, og tjek, om den samme handling allerede er indsendt. Gennemgå det tidligere svar eller den resulterende handling, inden du sender den igen.
• Følg endpointets vejledning om konflikter og idempotens i udviklerdokumentationen.

Din integration sender anmodninger for hyppigt.

• Tjek svaroverskrifter for vejledning om nye forsøg eller satsgrænser.
• Reducer anmodningsfrekvensen, og undgå øjeblikkelige nye forsøg i en stram løkke.
• Brug eksponentiel tilbageholdelse i overensstemmelse med endpointets vejledning om nye forsøg.

Hvis problemet fortsætter ved få anmodninger, skal du oplyse din anmodningsfrekvens og adfærd ved nye forsøg, når du kontakter support.

Der opstod en fejl på serversiden. Indsaml fejlsvaret og de anmodningsoplysninger, der er angivet under "Har du stadig brug for hjælp?", og kontakt support. Angiv, om fejlen skete én gang, eller om den sker gentagne gange.

Hvis webhook-hændelser ikke når frem til eller behandles af din integration:

• Tjek tilgængelighed. Dit modtagende endpoint skal være offentligt tilgængeligt via HTTPS og må ikke blokere anmodninger fra Pleo.
• Tjek leveringslogge. Kig efter leveringsforsøget, svarstatus og svartid. Returner et 2xx-svar hurtigt i overensstemmelse med kravene i webhook-dokumentationen.
• Tjek signaturverificeringen. Brug anmodningsteksten i den form, der kræves af webhook-dokumentationen, herunder den rå tekst, hvor det er angivet.
• Håndter duplikerede leveringer sikkert. Fjer dubletter ved hjælp af den hændelses- eller webhook-identifikator, der er angivet i dokumentationen.

Tjek en efterfølgende levering, når du har foretaget en ændring. Hvis leveringen stadig mislykkes, skal du inkludere abonnements-id'et, hændelses- eller webhook-id'et, tidsstemplet for leveringen, endpointets svarstatus og rensede logge, når du kontakter support.