Preparar una competencia - Exura Tech · Integración para brokers

Requisitos

Exura Tech debe tener creada la compañía del broker y una conexión MT5 activa asociada.
Un administrador debe disponer de sesión para /admin/competitions o de autorización administrativa para la API.
La API y el frontend deben tener URL públicas configuradas. Las variables del servidor COMPETITION_PUBLIC_API_URL y COMPETITION_PUBLIC_FRONTEND_URL determinan los enlaces entregados al CRM. No uses localhost fuera de desarrollo.
El broker debe decidir la ventana, la lista de premios y, si quiere avisos de cierre, una URL HTTPS para webhook.

Crear desde el panel

Abre /admin/competitions, selecciona Crear competencia, define compañía, conexión, nombre, slug, inicio y fin. El formulario permite premios por puesto o rango. Copia el UUID, la ruta de registro y el enlace público desde Integración CRM. Genera la clave y guárdala en el servidor del CRM; la respuesta en texto claro aparece una sola vez.

Crear mediante la API administrativa

POST /api/v1/competitions
Authorization: Bearer <admin-session>
Content-Type: application/json

{
  "company_id": 1,
  "connection_id": 2,
  "name": "Competencia de ejemplo",
  "slug": "competencia-ejemplo",
  "start_at": "2026-11-01T12:00:00Z",
  "end_at": "2026-11-03T12:00:00Z",
  "prizes": [{"rank_from": 1, "rank_to": 1, "prize_type": "CASH", "amount": "500.00", "currency": "USD"}]
}

El fin debe ser futuro y posterior al inicio. Se aceptan offsets como -05:00; el servidor los normaliza a UTC. La respuesta 201 contiene el UUID, registration_endpoint y ranking_link. También puedes recuperarlos con GET /api/v1/competitions/{uuid}/integration usando sesión administrativa. Genera o rota la clave con POST /api/v1/competitions/{uuid}/integration-key. La respuesta devuelve token una sola vez. Rotarla invalida la anterior inmediatamente: cambia el secreto en el CRM antes de reanudar inscripciones.

La clave CRM no autoriza POST /api/v1/competitions ni PUT /api/v1/competitions/{uuid}. Para automatizar la creación, usa un backend con una sesión administrativa autorizada y controles de acceso propios.

API administrativa

Consulta autenticación, compañías, conexiones y creación desde un panel propio.

Qué token usar

El token de admin crea y configura; la integration key inscribe logins.

​Requisitos

​Crear desde el panel

​Crear mediante la API administrativa

API administrativa

Qué token usar

Requisitos

Crear desde el panel

Crear mediante la API administrativa