Envía el encabezado Authorization: Bearer <key> en cada llamada. Una clave inválida responde 401; una clave válida sin el scope del endpoint responde 403.
El encabezado
Toda solicitud a la API externa lleva el encabezado Authorization con el valor "Bearer" seguido de la clave. La URL base y la referencia interactiva están en la página de documentación de la API; la especificación OpenAPI 3.1 está en /openapi.json y se puede importar en Postman, Bruno o en el generador de clientes de tu lenguaje.
Códigos de respuesta
Sin encabezado, o con una clave inválida o revocada, la respuesta es 401. Con una clave válida que no tiene el scope que exige el endpoint (por ejemplo, POST /employees sin employees:write), la respuesta es 403 y el cuerpo indica qué scope falta. Los errores de validación llegan como 422 con la lista de campos y mensajes, en el idioma del encabezado Accept-Language.
Idioma y formato
Envía Accept-Language (pt-BR, en, es, de o ru) para recibir mensajes de error traducidos. Las fechas entran y salen en ISO 8601, los importes monetarios como números decimales con la moneda al lado, y las respuestas de listas están paginadas.