Problemen met Pleo API-fouten oplossen

Het verzoek is ongeldig of komt niet door de validatie.

• Lees de tekst van de melding om ontbrekende velden of ongeldige waarden te vinden.
• Vergelijk je verzoek met de endpointdocumentatie. Controleer verplichte velden, de structuur van het verzoek, datumindelingen en toegestane waarden.
• Los het gevonden probleem op en probeer het verzoek opnieuw uit te voeren.

Het verzoek kon niet worden geverifieerd.

• Koppel de gegevens aan de API en omgeving. Controleer de host van het verzoek aan de hand van de ontwikkelaarsdocumentatie. Gebruik geen gegevens van de nieuwe API en de Legacy-API door elkaar, en ook geen staging- en productiegegevens.
• Controleer de autorisatieheader (`Authorization`). Nieuwe API-sleutels gebruiken Basic-authenticatie, waarbij de sleutel de gebruikersnaam is en het wachtwoord leeg blijft. OAuth-toegangstokens gebruiken Bearer-authenticatie. Volg de Legacy-API-documentatie voor verouderde tokens. Verwijder per ongeluk toegevoegde spaties of regeleinden uit de gegevens.
• Controleer de status van de inloggegevens. Bevestig dat deze niet zijn verlopen of ingetrokken. Gebruik voor OAuth het toegangstoken (niet het vernieuwingstoken) en controleer of de tokenvernieuwingsflow werkt.

Het verzoek is geverifieerd, maar toegang is niet toegestaan.

• Controleer de scopes. Vergelijk de scopes die aan je gegevens zijn toegewezen met de scopes die het endpoint vereist. Kun je ze niet bekijken? Vraag dan degene die de inloggegevens beheert om ze te bevestigen.
• Controleer het bedrijf en de omgeving. De gegevens moeten overeenkomen met het bedrijf of de entiteit waarvan je gegevens opvraagt en met de omgeving die je aanroept.
• Controleer de beschikbaarheid van het endpoint. Bevestig in de ontwikkelaarsdocumentatie dat het endpoint je authenticatiemethode en use case ondersteunt.

Komen deze overeen, maar wordt toegang nog steeds geweigerd? Neem dan contact op met de ondersteuning om de API-toegang van het bedrijf te bevestigen. Vermeld of dezelfde gegevens werken op andere endpoints.

Het aangevraagde endpoint of de aangevraagde resource kon niet worden gevonden.

• Vergelijk de basis-URL, de API-versie en het endpointpad met de ontwikkelaarsdocumentatie.
• Bevestig dat de resource-ID de resource aanduidt die je wilde opvragen.
• Controleer of de resource hoort bij het bedrijf en de omgeving die aan de gegevens zijn gekoppeld. Gebruik geen staging- en productie-ID's door elkaar.

Een resource kan 404 retourneren, wanneer deze bij een ander bedrijf of een andere omgeving hoort, zelfs als deze bestaat in Pleo.

Het verzoek conflicteert met een bestaande bewerking of status.

• Lees de foutmelding en controleer of dezelfde bewerking al is ingediend. Beoordeel het vorige antwoord of de resulterende bewerking voordat je deze opnieuw verstuurt.
• Volg de richtlijnen voor conflicten en idempotentie van het endpoint in de ontwikkelaarsdocumentatie.

Je integratie verstuurt te vaak verzoeken.

• Controleer de antwoordheaders voor richtlijnen over opnieuw proberen of de tarieflimieten.
• Verlaag de frequentie van verzoeken en probeer niet direct opnieuw.
• Gebruik exponentiële back-off volgens de richtlijnen van het endpoint voor opnieuw proberen.

Blijft dit gebeuren bij een laag aantal verzoeken? Vermeld dan de frequentie van je verzoeken en wat je doet als je opnieuw probeert wanneer je contact opneemt met de ondersteuning.

Er is een fout aan serverzijde opgetreden. Documenteer de foutmelding en de verzoekgegevens die onder 'Nog steeds hulp nodig?' staan vermeld en neem contact op met de ondersteuning. Vermeld of dit één keer gebeurde of herhaaldelijk voorkomt.

Als webhookgebeurtenissen je integratie niet bereiken of niet worden verwerkt door je integratie:

• Controleer de bereikbaarheid. Je ontvangende endpoint moet openbaar toegankelijk zijn via HTTPS en mag verzoeken van Pleo niet blokkeren.
• Controleer de bezorglogs. Zoek naar de bezorgpoging, antwoordstatus en responstijd. Stuur snel een 2xx-antwoord terug, volgens de vereisten in de webhookdocumentatie.
• Controleer de handtekeningverificatie. Gebruik de verzoektekst in de vorm die de webhookdocumentatie vereist, inclusief de onbewerkte tekst waar aangegeven.
• Verwerk dubbele leveringen veilig. Ontdubbel met de gebeurtenis- of webhook-ID die in de documentatie staat vermeld.

Controleer na een wijziging een volgende levering. Mislukt die nog steeds? Vermeld dan de abonnements-ID, de gebeurtenis- of de webhook-ID, de tijdstempel van de bezorging, de antwoordstatus van het endpoint en geanonimiseerde logs wanneer je contact opneemt met de ondersteuning.