Autenticación
Cada empresa tiene su propia clave. La clave identifica a tu empresa: no hace falta (ni se puede) indicar un tenant o cliente en la llamada.
El header Authorization
Enviá la clave como token Bearer en cada llamada:
Authorization: Bearer mgt_live_<id8>_<secret32>
El formato es mgt_live_, 8 caracteres hexadecimales de identificador, un guion bajo y un secreto de 32 caracteres. El secreto puede contener _ y -: tratá la clave como un texto opaco y no la separes por guiones bajos.
Es un secreto
Permisos de la clave
Cada clave se crea con uno o más permisos, que elegís al crearla en Mi Organización → API. Si falta el permiso del recurso que pedís, la API responde 403 forbidden.
| Campo | Tipo | Descripción |
|---|---|---|
| customs:read | permiso | "Despachos". Habilita /despachos. |
| billing:read | permiso | "Facturación". Habilita /facturas. |
GET /ping sirve con cualquier clave válida, sin importar el permiso. La clave ve los datos de toda tu cuenta: todos los despachos y comprobantes de tu empresa.
Vencimiento
Una clave vence a los 12 meses de creada. Pasada la fecha, la API responde 401 (igual que con una clave inexistente). Renová con tiempo.
Rotación sin cortes
Para cambiar una clave sin cortar tu integración:
- Rotá la clave desde Mi Organización → API en el portal. Se genera una clave nueva y se muestra una sola vez.
- La clave anterior sigue funcionando 7 días desde la rotación (o hasta su vencimiento, si ese llega antes).
- En ese plazo, actualizá el secreto en tu sistema y verificá con
GET /ping. Después de los 7 días la anterior deja de servir.
No se puede rotar una clave ya vencida o anulada: en ese caso creá una nueva en Mi Organización → API. Podés tener hasta 3 claves activas.
Anulación
Si una clave se filtra o alguien con acceso deja tu empresa, anulala desde Mi Organización → API en el portal. Deja de funcionar al instante; no hay período de gracia. Después creá una nueva.
Si perdiste la clave
La clave se muestra una sola vez al crearla. No guardamos el valor, solo una huella, así que no podemos recuperarla. Anulala desde Mi Organización → API y creá otra.