Obtén una clave de API de Sintropix para agentes e integraciones

1

Inicia sesión y abre Ajustes

Inicia sesión como el Usuario en cuyo nombre actuará la clave. La clave hereda el Rol de ese Usuario y sus Membresías por Entidad, así que elige un Usuario con el acceso que la integración realmente necesita.Haz clic en tu nombre, en la parte inferior de la barra lateral izquierda, y elige Ajustes.

2

Ve a Claves de API

Ajustes se abre en la página Empresa. En la lista Configuración de la izquierda, haz clic en Claves de API.

La página lista todas las claves que te pertenecen con su nombre, prefijo, fecha de creación, vencimiento y último uso. Puedes revocar una clave desde el ícono de papelera de cada fila.

3

Crea la clave

Haz clic en Crear clave. Dale a la clave un nombre descriptivo (por ejemplo erwin-agent o reconciliation-bot) para poder identificarla después en la lista de claves y en el registro de auditoría, y luego haz clic en Crear clave en el diálogo.

4

Copia el secreto

La clave se muestra una sola vez. Cópiala con el botón junto al campo y guárdala en tu gestor de secretos antes de hacer clic en Listo. Sintropix no vuelve a mostrar el secreto después de esta pantalla; si lo pierdes, revoca la clave y crea una nueva.

5

Llama a la API

Envía la clave en el encabezado x-api-key en cada solicitud:

curl https://api.sintropix.com/api/entities \
  -H "x-api-key: $SINTROPIX_API_KEY"

Toda solicitud que modifica datos (POST, PUT, PATCH, DELETE) hecha con una clave debe enviar además un encabezado x-audit-actor con el nombre del software que actúa. El valor se registra tal cual en el registro de auditoría; omitirlo devuelve 400.

curl -X POST https://api.sintropix.com/api/entities/$ENTITY_ID/partners \
  -H "x-api-key: $SINTROPIX_API_KEY" \
  -H "x-audit-actor: my-agent" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "0b6c0f2e-5a4d-4e8f-b1c3-7d9e2a4f6c88",
    "name": "Servicios Cloud SpA",
    "type": "vendor",
    "country": "CL",
    "taxId": "76123456-0"
  }'

Las solicitudes a /api/auth/* se rechazan cuando llevan x-api-key, así que una clave no puede usarse para crear más claves ni para administrar Usuarios.

​

Alcance y permisos

• Una clave se autentica como su Usuario propietario, con el Rol global de ese Usuario y sus Membresías por Entidad.
• Las rutas de negocio están acotadas por Entidad (/api/entities/{entityId}/...). Una clave solo puede acceder a las Entidades de las que el Usuario propietario es miembro.

​

Límites de solicitudes

​

Rotación y revocación

• Rota las claves de forma periódica y cada vez que un miembro del equipo con acceso deje la empresa.
• Revoca una clave de inmediato desde Ajustes → Claves de API si sospechas que se filtró. La revocación aplica desde la siguiente solicitud.
• Toda acción realizada con una clave queda registrada en el registro de auditoría bajo el Usuario propietario, así que la actividad de una clave filtrada es rastreable.