Waarom worden mijn API-aanroepen met 401 afgewezen?

Elk endpoint van de faktoora-API vereist authenticatie met een API-sleutel. Ontbreekt deze sleutel in het request of is hij ongeldig, dan antwoordt de API met HTTP-status 401 en de melding "Unauthorized request".

Hoe de authenticatie werkt

De API verwacht de sleutel in de HTTP-header X-API-KEY. Volgens de API-documentatie geldt:

Een API-sleutel is vereist om toegang te krijgen tot de API. De API-sleutel (X-API-KEY) kan in uw faktoora-accountinstellingen worden aangemaakt.

Vrijwel elk endpoint heeft deze header nodig: van het aanmaken van een factuur (POST /invoices) en het opvragen van factuurgegevens tot het beheren van klanten, producten en webhooks.

Typische oorzaken van een 401-fout

• De header X-API-KEY ontbreekt volledig in het request.
• De headernaam is verkeerd gespeld, bijvoorbeeld X-API_KEY of X-APIKEY.
• De sleutel wordt als queryparameter of in de body meegegeven in plaats van als header.
• De verzonden waarde is geen geldige API-sleutel die in uw account is aangemaakt.

Hoofdletters en kleine letters in de headernaam maken daarbij niet uit: HTTP behandelt headernamen ongeacht de schrijfwijze, x-api-key en X-API-KEY zijn gelijkwaardig.

Zo lost u het op

1. Open in uw faktoora-account het onderdeel API-toegang (bereikbaar via het menu bij uw profielfoto; in hetzelfde onderdeel stelt u ook webhooks in).
2. Controleer of daar een API-sleutel is opgeslagen en maak indien nodig een nieuwe aan.
3. Stuur de sleutel in elk request mee, precies als header X-API-KEY: <uw-sleutel>.