1. Conseguir un API token
Los integradores usan un API token de larga duración, con prefijo atk_. Crearlo
requiere una sesión de usuario (no un API token: administrar tus propios tokens está
reservado a la sesión, ver Autenticación), así que se emite desde la
plataforma, iniciando sesión con un usuario que tenga el permiso access_api_keys. Si no
tenés ese acceso, pedile el token al administrador de tu cuenta.
El token se muestra una sola vez, al crearlo. Guardalo en tu gestor de secretos: no se
puede recuperar después.
2. Llamar a la API
Respuesta (recortada):
3. Verificar que la API está viva
GET /health no necesita credenciales y es útil para monitoreo:
Siguiente paso
Los detalles de los dos esquemas de credenciales están en
Autenticación. Cuando un request falle, el
catálogo de códigos de error explica qué significa cada code.