¿Cómo crear y revocar llaves API en Dataico?
Si integras un sistema propio con Dataico, puedes crear y revocar tus propias llaves API desde la plataforma. Así cada integración tiene su credencial, y puedes cortar una sin afectar las demás.
Requisitos previos
Ser administrador de la cuenta y tener claro para qué integración vas a crear la llave.
Cómo crear una llave
- Ve a Opciones > Configuración y haz clic en el botón Llaves API.
- Haz clic en Nueva llave API.
- En Nombre, escribe algo que te permita reconocer la integración. Por ejemplo: Sincronización Dataico, Punto de venta tienda norte, ERP.
- En Vence el, elige la fecha de vencimiento. Es obligatoria y debe ser futura; Dataico propone un año.
- En Alcance, deja Empresa, salvo que seas aliado y quieras usar la misma llave para tus empresas hijas (Administración de aliado).
- Haz clic en Crear llave.
- Copia la llave y guárdala de inmediato en un lugar seguro.
⚠️ La llave se muestra una sola vez. Si refrescas la página o sales de la pantalla, no la vuelves a ver: Dataico solo guarda una huella de la llave, nunca la llave misma. Esto es a propósito, y es lo que hace que nadie, ni siquiera Dataico, pueda recuperarla ni filtrarla. Si la pierdes, crea otra y revoca la anterior.
Cómo usar la llave
Envía la llave en el encabezado Auth-token de cada petición, el mismo encabezado que usa el Auth Token de la cuenta:
Auth-token: <tu llave API>
En la factura, la Nota Crédito y la Nota Débito, el campo dataico_account_id del cuerpo debe ser el Dataico Account Id de la empresa a la que pertenece la llave (o el de la empresa hija, si eres aliado y usas x-on-behalf-of).
Cómo revocar una llave
- Ve a Opciones > Configuración y haz clic en el botón Llaves API.
- Ubica la llave en el listado. Ahí también puedes ver cuándo se usó por última vez.
- Revócala y confirma.
Acción según el resultado
| Situación | Qué hacer |
|---|---|
| Perdiste la llave sin haberla copiado | No se puede recuperar. Crea una nueva y revoca la anterior |
| Revocaste una llave y una petición todavía pasa | Vuelve a probar en unos minutos. Si la llave sigue respondiendo, escríbenos al chat de soporte |
| El listado dice que una llave nunca se ha usado y sabes que sí | La fecha de último uso se registra en bloques, así que un uso de hace unos segundos puede no aparecer todavía |
Recibes No estás autorizado para usar esta cuenta de DATAICO, por favor revisa los datos de conexión 'Dataico Account Id' y 'Auth Token'. (HTTP 401) |
Verifica que la llave esté completa, sin espacios al copiarla, y que no haya sido revocada |
Recibes Tu API key expiró. Genera una nueva desde la configuración de tu empresa. (HTTP 401) |
La llave llegó a su fecha de vencimiento. Crea una nueva y reemplázala en tu integración |
Recibes Debe enviar un dataico account id válido (debe ser un uuid como a7ec34ae-f30b-40e8-b3a8-93bfc4c37d70) |
La llave es válida, pero el dataico_account_id del cuerpo no es el de la empresa de la llave. Ver Error API: Debe enviar un dataico account id válido |
Si eres aliado y administras varias empresas
Con una sola llave de alcance Administración de aliado puedes operar sobre cualquiera de tus empresas hijas. En cada petición envía, además del Auth-token, el encabezado x-on-behalf-of con el Dataico Account Id (UUID) de la empresa sobre la que quieres actuar. La operación se ejecuta como esa empresa.
Solo las empresas aliadas pueden crear llaves de este alcance. Una llave de alcance Empresa sirve únicamente para la empresa que la creó.
| Mensaje | Causa | Qué hacer |
|---|---|---|
Una API key de administración de aliado requiere el encabezado 'x-on-behalf-of' con el UUID de la empresa destino. (HTTP 400) |
Usaste una llave de aliado sin el encabezado | Agrega x-on-behalf-of con el UUID de la empresa hija |
Esta API key no permite actuar en nombre de otra empresa. Usa una llave de administración de aliado, o quita el encabezado 'x-on-behalf-of'. (HTTP 400) |
Enviaste x-on-behalf-of con una llave de alcance Empresa |
Quita el encabezado o usa una llave de alcance Administración de aliado |
La empresa destino no está referida por tu empresa, o tu empresa ya no es un aliado. (HTTP 403 o 404) |
El UUID no corresponde a una de tus empresas hijas, o tu empresa ya no es aliada | Revisa el UUID que envías en x-on-behalf-of |
¿Qué pasa después?
- La llave queda activa hasta que la revoques o hasta su fecha de vencimiento.
- Puedes tener varias llaves al mismo tiempo, una por integración.
- El Auth Token de la cuenta (el que aparece en Opciones > Configuración) sigue funcionando: las llaves API no rompen tus integraciones existentes. Ese token también se puede revocar desde la misma pantalla, pero después no hay forma de generar otro: las integraciones nuevas usan llaves API. Si tienes la integración con Shopify, ten en cuenta que depende de ese token (ver Manual de configuración de Shopify).
Otros artículos que pueden interesar
Artículos relacionados
¿Este artículo te fue útil?