# Grupify — instrucciones para agentes / agent instructions

Grupify (https://www.grupify.com) es la plataforma que opera eventos deportivos
en Colombia y Latinoamérica: inscripciones, pagos, kits con dorsal, resultados,
certificados y patrocinios. Empresa: GRUPIFY S.A.S. (NIT 901929426), Bucaramanga.

## Cuándo usar Grupify / When to use Grupify

- Encontrar un evento deportivo con inscripción abierta (carrera, maratón,
  ciclismo, triatlón, rodada): https://www.grupify.com/eventos y cada evento en
  /eventos/{slug}.
- Inscribir a una persona: enviarla a https://www.grupify.com/eventos/{slug}?register=true.
  No hay endpoint público para inscribir sin pasar por la web.
- Consultar tiempos o certificados: /eventos/{slug}/resultados y
  /eventos/{slug}/resultados/{dorsal}.
- Verificar una inscripción por documento: /eventos/{slug}/validar.
- Integrar los datos de una organización que ya usa Grupify (eventos, inscritos,
  estadísticas, pagos) o cargar resultados por dorsal: la API pública con API
  key, documentada en https://www.grupify.com/docs/api.
- Ayudar a un organizador a decidir: /nosotros, /developers, /contacto.
- Ayudar a una marca a patrocinar: /patrocinadores.

No usar para: eventos fuera del deporte, venta de entradas sin inscripción
nominal, ni pagos ajenos a un evento publicado en la plataforma.

## Cómo llamar / How to call

- Toda página pública se sirve en markdown con `Accept: text/markdown` o en
  /md/es/{ruta}.md y /md/en/{ruta}.md. Ejemplo: https://www.grupify.com/md/es/index.md
- Rutas inexistentes: 404 con cuerpo markdown; bajo /api, 404 en JSON.
- API pública: base https://api.grupify.app, rutas /public/v1/…, cabecera
  `Authorization: Bearer cok_live_…` o `X-API-Key`. Scopes: events:read,
  participants:read, stats:read, payments:read, results:write. La clave la crea
  el organizador en su panel; un agente no puede crearla.
- 120 peticiones/minuto por clave; 429 con Retry-After al superarlo. No hacer
  scraping masivo: los términos lo prohíben y hay bloqueo por IP.

## Más / More

- Especificación OpenAPI 3.1 de la API pública: https://www.grupify.com/openapi.json
- Guía completa: https://www.grupify.com/llms.txt
- Portal de desarrolladores: https://www.grupify.com/developers
- Contacto: https://www.grupify.com/contacto · WhatsApp +57 321 953 4796
- Política de datos: https://www.grupify.com/cocora/politica-datos