Pourquoi mes appels API sont-ils rejetés avec une erreur 401 ?

Chaque point de terminaison de l'API faktoora exige une authentification par clé API. Si cette clé est absente de la requête ou invalide, l'API répond avec le statut HTTP 401 et le message « Unauthorized request ».

Comment fonctionne l'authentification

L'API attend la clé dans l'en-tête HTTP X-API-KEY. La documentation de l'API précise :

Une clé API est nécessaire pour accéder à l'API. La clé API (X-API-KEY) peut être générée dans les paramètres de votre compte faktoora.

Pratiquement tous les points de terminaison ont besoin de cet en-tête, de la création d'une facture (POST /invoices) à la gestion des clients, des produits et des webhooks, en passant par la récupération des données de facture.

Causes typiques d'une erreur 401

• L'en-tête X-API-KEY est totalement absent de la requête.
• Le nom de l'en-tête est mal orthographié, par exemple X-API_KEY ou X-APIKEY.
• La clé est transmise comme paramètre de requête (query) ou dans le corps au lieu d'un en-tête.
• La valeur transmise n'est pas une clé API valide générée dans votre compte.

La casse du nom de l'en-tête n'a aucune importance : HTTP traite les noms d'en-tête indépendamment de leur écriture, x-api-key et X-API-KEY sont équivalents.

Comment résoudre le problème

1. Dans votre compte faktoora, ouvrez la section Accès API (accessible via le menu de votre photo de profil, la même section que celle où vous configurez les webhooks).
2. Vérifiez qu'une clé API y est enregistrée et générez-en une nouvelle si nécessaire.
3. Transmettez la clé dans chaque requête exactement sous la forme de l'en-tête X-API-KEY: <votre-clé>.