fbpx

Copérnico

Como conectar la API de inscripciones a Copérnico/Sportmaniacs

Puedes conectar cualquier plataforma de inscripciones a Copérnico para cronometrar carreras virtuales.

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 puedes añadir cualquier otro campo que desees que aparezca en Copérnico

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

Ejemplo 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

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

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 Copérnico}}.
    • Valor que clasifica: El valor por el que clasifica el atleta en este caso es «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 pueden haber varios valores, por ejemplo, una clasificación por profesiones, en las 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 Copérnico?

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 accedes 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 accedes 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. 

 

 

 

¿Te ha sido útil este artículo?

NoSí
Cargando...