Felsökning av Pleo API-fel

Begäran är ogiltig eller klarar inte valideringen.

• Läs svarstexten för att identifiera fält som saknas eller ogiltiga värden.
• Jämför din begäran med endpoint-dokumentationen. Kontrollera obligatoriska fält, begäransstruktur, datumformat och tillåtna värden.
• Åtgärda det identifierade problemet och försök igen med begäran.

Begäran kunde inte autentiseras.

• Matcha inloggningsuppgifterna mot API:et och miljön. Kontrollera begärans host mot utvecklardokumentationen. Blanda inte inloggningsuppgifter för det nya API:et och Legacy API, eller inloggningsuppgifter för staging och produktion.
• Kontrollera auktoriseringsrubriken (`Authorization`). Nya API-nycklar använder Basic-autentisering, med nyckeln som användarnamn och ett tomt lösenord. OAuth-åtkomsttoken använder Bearer-autentisering. Följ Legacy API-dokumentationen för äldre token. Ta bort oavsiktliga mellanslag eller radbrytningar från inloggningsuppgifterna.
• Kontrollera inloggningsuppgifternas status. Bekräfta att de inte har löpt ut eller återkallats. För OAuth använder du åtkomsttoken – inte uppdateringstoken – och kontrollerar att token-uppdateringsflödet fungerar.

Begäran autentiserades, men åtkomst är inte tillåten.

• Kontrollera omfattningar. Jämför inloggningsuppgifternas tilldelade scopes med de som krävs av endpoint. Om du inte kan se dem ber du den som hanterar inloggningsuppgifterna att bekräfta dem.
• Kontrollera företaget och miljön. Inloggningsuppgifterna måste matcha det företag eller bolag vars data du begär och den miljö du anropar.
• Kontrollera endpoint-tillgängligheten. Bekräfta i utvecklardokumentationen att endpoint stöder din autentiseringsmetod och ditt användningsfall.

Om dessa stämmer överens men åtkomst fortfarande nekas kontaktar du Support för att bekräfta företagets tillgång till API. Ange om samma inloggningsuppgifter fungerar på andra endpoints.

Det gick inte att hitta begärd endpoint eller resurs.

• Jämför bas-URL, API-version och endpoint-sökväg med utvecklardokumentationen.
• Bekräfta att resurs-ID:t identifierar den resurs du avsåg att begära.
• Kontrollera att resursen tillhör det företag och den miljö som är kopplad till inloggningsuppgifterna. Blanda inte staging- och produktions-ID:n.

En resurs kan returnera 404 även om den finns i Pleo, om den tillhör ett annat företag eller en annan miljö.

Begäran är i konflikt med en befintlig åtgärd eller ett befintligt tillstånd.

• Läs felsvaret och kontrollera om samma åtgärd redan har skickats in. Granska det tidigare svaret eller den resulterande åtgärden innan du skickar in den igen.
• Följ endpoint:ens vägledning om konflikter och idempotens i utvecklardokumentationen.

Din integration skickar förfrågningar för ofta.

• Kontrollera svarsrubriker för vägledning om nya försök eller taxa-gränser.
• Minska förfrågningsfrekvensen och undvik omedelbara nya försök i en tät loop.
• Använd exponentiell backoff och följ endpoint-vägledningen för nya försök.

Om detta fortsätter vid låg förfrågningsvolym, inkludera din förfrågningsfrekvens och beteende vid nya försök när du kontaktar Support.

Ett serversidesfel inträffade. Samla in felsvaret och förfrågningsuppgifterna som listas under "Behöver du fortfarande hjälp?" och kontakta Support. Ange om det hände en gång eller uppstår upprepade gånger.

Om webhook-händelser inte når eller bearbetas av din integration:

• Kontrollera nåbarhet. Din mottagande endpoint måste vara offentligt tillgänglig via HTTPS och får inte blockera förfrågningar från Pleo.
• Kontrollera leveransloggar. Leta efter leveransförsöket, svarsstatusen och svarstiden. Returnera ett 2xx-svar omgående i enlighet med webhook-dokumentationens krav.
• Kontrollera signaturverifiering. Använd förfrågningens brödtext i det format som krävs av webhook-dokumentationen, inklusive råtexten där det anges.
• Hantera dubblerade leveranser på ett säkert sätt. Deduplicera med hjälp av händelse- eller webhook-identifieraren som anges i dokumentationen.

När du har gjort en ändring kontrollerar du en efterföljande leverans. Om den fortfarande misslyckas, inkludera prenumerations-ID, händelse- eller webhook-ID, leveranstidsstämpel, endpointens svarsstatus och rensade loggar när du kontaktar supporten.