Autenticación y acceso
Una clave identifica una integración
Sección titulada «Una clave identifica una integración»Un administrador gestiona las claves API en API & integrations. Cada clave pertenece a un grupo, no a una persona. Puedes crear varias claves con nombre, establecer una fecha de vencimiento o dejarla sin vencimiento, sustituirlas y revocarlas. El secreto completo solo aparece una vez; después, la interfaz muestra su prefijo y los datos de uso. Guárdalo en un gestor de secretos del servidor, nunca en un navegador ni en una aplicación móvil.
Envía la clave en cada petición a la API pública:
Authorization: Bearer YOUR_API_KEYEn el campo Bearer Token de Scalar, pega solo la clave. Scalar añade Bearer al encabezado HTTP automáticamente. No pegues un segundo prefijo Bearer en ese campo.
El socio no inicia sesión para obtener un token de acceso o de renovación. TrakarIA comprueba la clave, sus permisos, el estado de la organización y los derechos de su plan. Una clave revocada o caducada deja de funcionar en las peticiones siguientes. Usa claves distintas para tus diferentes aplicaciones, de modo que puedas sustituirlas por separado.
El enlace de inspección requiere una persona conectada
Sección titulada «El enlace de inspección requiere una persona conectada»La clave API autentica tu software. El enlace de lanzamiento indica qué inspección se debe abrir, pero el empleado también debe iniciar sesión en la interfaz de TrakarIA. Nunca coloques la clave API en el enlace. Estos enlaces caducan pronto y pueden renovarse mediante la API.
URL de la API
Sección titulada «URL de la API»Envía las peticiones a https://api.trakaria.com. GET /v1/capabilities indica las funciones y límites aplicables a una clave válida. Puedes empezar con una petición de solo lectura antes de crear expedientes en tu cuenta.