¿Por qué mis llamadas a la API se rechazan con un error 401?

Todos los endpoints de la API de faktoora requieren autenticación mediante una clave de API. Si la clave falta en la solicitud o no es válida, la API responde con el estado HTTP 401 y el mensaje "Unauthorized request".

Cómo funciona la autenticación

La API espera la clave en la cabecera HTTP X-API-KEY. Según la documentación de la API:

Se necesita una clave de API para acceder a la API. La clave de API (X-API-KEY) se puede generar en los ajustes de su cuenta de faktoora.

Prácticamente todos los endpoints necesitan esta cabecera: desde la creación de una factura (POST /invoices) y la obtención de datos de facturas hasta la gestión de clientes, productos y webhooks.

Causas habituales de un error 401

• Falta por completo la cabecera X-API-KEY en la solicitud.
• El nombre de la cabecera está mal escrito, por ejemplo X-API_KEY o X-APIKEY.
• La clave se transmite como parámetro de consulta o en el cuerpo en lugar de como cabecera.
• El valor transmitido no es una clave de API válida generada en su cuenta.

El uso de mayúsculas y minúsculas en el nombre de la cabecera no importa: HTTP trata los nombres de cabecera con independencia de cómo estén escritos, por lo que x-api-key y X-API-KEY son equivalentes.

Cómo solucionarlo

1. En su cuenta de faktoora, abra la sección "Acceso a la API" (accesible desde el menú de su foto de perfil; es la misma sección en la que también se configuran los webhooks).
2. Compruebe si hay una clave de API guardada y, si es necesario, genere una nueva.
3. Incluya la clave en cada solicitud exactamente como cabecera X-API-KEY: <su-clave>.