Autenticación

Encabezados HTTP

Las peticiones a la API deben incluir los siguientes encabezados HTTP:

X-API-KEY: la clave de API, que se obtiene desde el apartado “Claves de API” de la sección “Configuración” de la aplicación web de tukonta.
Content-Type: application/json. En POST /expenses/:id/attachment el valor es multipart/form-data.
Accept: application/json.

Errores de autenticación

Las claves de API de producción empiezan por tuk_ y las del entorno de pruebas por tuk_test_. Si falta la clave, no tiene ese formato, no existe, es del otro entorno, está desactivada, ha caducado o la empresa no tiene un plan activo, la respuesta es 401 con el encabezado WWW-Authenticate: Bearer realm="tukonta" y un mensaje que indica el motivo:

{ "error": true, "message": "API key inválida" }

Un 401 no se arregla reintentando: hay que corregir la clave.

Una clave de solo lectura puede consultar, pero no crear, cambiar ni eliminar: esas peticiones responden 401 con «No tienes permisos para hacer esta acción.».