Skip to main content
Las competencias usan dos credenciales bearer independientes. Aunque ambas se envían en la cabecera Authorization, la API comprueba un tipo distinto en cada ruta. No son intercambiables.
Un token de admin no registra participantes en POST /api/v1/integrations/competitions/{uuid}/participants. Ese endpoint exige la integration key de la competencia indicada en la URL. Enviarle el token de admin devuelve 401 Invalid integration key. La integration key tampoco permite crear ni editar competencias.

​
1. Obtener el token de admin

Un administrador autorizado inicia sesión con POST /api/v1/admin/auth/login y recibe access_token. Su rol y compañía determinan qué competencias puede gestionar. Exura Tech debe haber creado o autorizado esa cuenta administrativa. Un SUPER_ADMIN puede crear un token de sistema para un administrador mediante una ruta distinta, pero ese token sigue siendo administrativo, no una integration key CRM.
Con el mismo tipo de token se llama POST /api/v1/competitions/{uuid}/integration-key. La respuesta incluye token: ese nuevo valor es la integration key, se muestra una sola vez y debe entregarse por un canal seguro al backend del CRM.

​
2. Usar la integration key desde el CRM

El CRM debe conservar una clave de idempotencia estable por evento. Reintentar el mismo evento con el mismo login devuelve la inscripción existente; usar la misma clave para otro login devuelve 409. La clave de una competencia no sirve para inscribir en otra.

​
3. Publicar el ranking

GET /api/v1/competitions/{uuid}, GET .../leaderboard y GET .../participants/{participant_uuid}/history son públicos. Un frontend propio o el embed puede leerlos sin exponer ninguna de las dos credenciales. La inscripción, en cambio, debe salir del servidor del CRM, no de JavaScript público.

​
Rotación y almacenamiento

El secreto CRM solo se devuelve cuando se genera o rota. GET .../integration indica si existe, pero no permite recuperarlo. Una rotación invalida inmediatamente la clave anterior; coordina el cambio con el CRM. Guarda el token de admin en el backend o sesión administrativa segura y la integration key en un gestor de secretos del backend CRM. No los pongas en URL, iframe, repositorio público ni logs.

API administrativa

Inicio de sesión, roles y creación de competencias.

Registrar cuentas

Cuerpo, idempotencia y ventana de inscripción.