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.

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

Usala solo desde tu servidor. Si la ponés en una web o en una app móvil, cualquiera que la inspeccione puede leer los datos de tu empresa.

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.

CampoTipoDescripción
customs:readpermiso"Despachos". Habilita /despachos.
billing:readpermiso"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.