Cómo conectar la API de inscripciones a Copernico/Sportmaniacs

Puede conectar cualquier plataforma de inscripciones a Copernico para cronometrar carreras virtuales.

1. API Inscritos

POST https://api.copernico.cloud/race-registrations/{raceId}

• donde {raceId} es el id de Sportmaniacs*, por ejemplo: 5fbe1dc5-deb8-40dd-8a08-2375ac1f13d5
• headers: Content-Type: application/json
• body: listado de inscritos:

[{
  id: «identificador único de corredor»,
  name: «nombre de corredor»,
  surname: «apellido de corredor»,
  birthdate: «fecha de nacimiento de corredor en formato YYYY-MM-DD»,
  document: «identificador de la inscripción de corredor»,
  dorsal: «dorsal de corredor»,
  gender: «male | female | mixed»,
  raceId: «Identificador de la carrera» (en este caso 5edf7259-ed28-46f4-84f5-4972ac1f25ca),
  eventId: «identificador del evento»,
  …
}]

eventId:

• Marcha 5 kilómetros – 5edf72a1-dc24-464e-915e-4758ac1f25ca
• Carrera 10 km – 5edf72d5-da78-472c-8203-4972ac1f25ca
• Ruta ciclista 20 km – 5edf72fb-52b4-4b1b-a2f9-4972ac1f25ca

En la inscripción puede añadir cualquier otro campo que desee que aparezca en Copernico.

El ID de carrera o race id de Sportmaniacs es la parte resaltada en rojo en la URL:

https://panel.sportmaniacs.com/admin/events/races/view/5f85be81-b528-47eb-b5ec-205fac1f15a0

2. Ejemplo de archivo de importación

Nombres requeridos de las columnas:

• id
• dorsal
• name
• surname
• gender:
  • male
  • female
  • mixed
• birthdate:
  • yyyy-mm-dd
• eventName: si no tiene evento asignado se enviará el campo vacío.
• club
• document:
  • DNI/documento de identificación

Puede ver un fichero de ejemplo de importación de inscritos haciendo clic en este enlace.

3. Preguntas frecuentes

¿Cómo se envía la información para que el atleta pueda seleccionar la distancia en la aplicación?

Es necesario enviar la columna «event» vacía para que la aplicación deje seleccionar al atleta el evento en el que quiere participar.

¿Cómo se extrae una clasificación especial?

Utilizando los atributos, que son un valor extra que tiene cada atleta. Por ejemplo, para una clasificación de atletas locales, cada atleta deberá tener el atributo «local» = «SI».

Los atributos se componen de:

• Nombre de la columna: a través de la API se envía attr_ + {{ Nombre del atributo en Copernico }}.
• Valor que clasifica: el valor por el que clasifica el atleta, en este caso «SI».

Puede ocurrir que el atributo del atleta no se pueda resolver con un booleano («si» o «no») para extraer una clasificación, sino que haya varios valores; por ejemplo, una clasificación por profesiones en la que las profesiones son policía y bombero. En este caso el atleta deberá tener una columna llamada «attr_profesiones» y en la celda tendrá los valores: policía o bombero.

¿Qué información es necesaria en Deporticket para la integración con Copernico?

Para que lleguen los datos correctamente hay que introducir en la plataforma:

• Race id
• Event id de cada evento.

¿Cómo se obtiene el race id de una carrera?

Cuando accede a una carrera en Sportmaniacs, el navegador carga un enlace como el siguiente: https://panel.sportmaniacs.com/admin/events/races/view/57640500-c3ac-4afa-8f6b-6d55bc5ffd28. La parte resaltada en rojo es el race id.

¿Cómo se obtiene el event id de una carrera?

Cuando accede a un evento haciendo clic en «Ver evento» dentro de la carrera de Sportmaniacs, el navegador carga un enlace como el siguiente: https://panel.sportmaniacs.com/admin/events/eventraces/view/57640500-c3ac-4afa-8f6b-6d55bc5ffd28/57cd93f2-5aa0-4b05-8936-052cac1f1563. La parte resaltada en verde es el event id.