Il est possible de télécharger les start-lists et les résultats (pour une ou toutes les épreuves) à n'importe quel moment, avant, pendant, ou après votre compétition. Ceux-ci peuvent être téléchargés en format CSV manuellement ou automatiquement, et contiennent toutes les données de la compétition. Des exemples de scripts pour automatiser ce processus sont inclus en pièces jointes à la fin de ce document (.bat pour Windows, .sh pour linux/Mac).


Au cas où vous choisissiez un processus manuel de téléchargement, celui-ci pourra être fait à partir du menu DÉTAILS.



Il est aussi possible d'automatiser le processsus de téléchargement, et après avoir fait une petite configuration manuelle, ce processus pourra s'automatiser.


En anglais


This is how you set it up:

    1. Authenticate and store cookies (the important one is cookie named rac). 

  • data makes it a POST and sends the payload
  • c tells it to store cookies in a file named "cookiejar"


curl –data 'username=myaccount@gmail.com&password=super_secret_pass' -c cookiejar https://api.admin.rosterathletics.com/api/login


    2. Now using acquired cookies, you can fetch start lists or results in CSV

  • b tells curl to attach cookies from file "cookiejar", where we saved them in step 1.
  • c same as above; cookies can (and will) be refreshed, so it's essential to store them


101 is the competition id - you can see it referenced in the location bar when viewing our website. It would be here: https://admin.rosterathletics.com/meeting/101/details


Start lists:

curl -b cookiejar -c cookiejar https://api.admin.rosterathletics.com/api/admin/meeting/101/export-csv


Results:

curl -b cookiejar -c cookiejar https://api.admin.rosterathletics.com/api/admin/meeting/101/export-results-csv/v2


You can also download results for a single event. In the example below, 201 is the event id. You can see it referenced in the location bar when viewing our website. It would be here: https://admin.rosterathletics.com/admin/meeting/101/results?meIdPk=201


Results for single event:

curl -b cookiejar -c cookiejar https://api.admin.rosterathletics.com/api/admin/meeting/101/export-event/201



Cookies expire after 2h. So if no request is made for 2h (or you don't store refreshed cookies), you'll need to do step 1) again. 


A simple bash script for Linux/Mac could look like this (also attached as a .sh file):



Or for Windows like this (also attached as a .bat file):



Pour exemple, voir les 2 fichiers joints.


Protocole pour les tickets d'assistance concernant les problèmes d'API/script


Veuillez vérifier les points suivants avant de soumettre un ticket d'assistance :

  • Vous disposez d'une connexion Internet fonctionnelle.
  • Le numéro d'identification de l'événement est correct.
  • Vous disposez des autorisations appropriées pour l'événement.
  • Vous utilisez la dernière version du script (assurez-vous qu'aucun ancien script avec des domaines différents n'est utilisé).
  • Le nombre de colonnes dans la start-list et les fichiers CSV de résultats n'est pas statique. Selon l'événement des colonnes supplémentaires peuvent être présentes.
  • Si vous rencontrez le message d'erreur "La fonction de révocation n'a pas pu vérifier la révocation du certificat", votre logiciel antivirus pourrait bloquer l'opération. Pour résoudre ce problème, ajoutez api.admin.rosterathletics.com à la liste des sites web que le programme doit exclure de l'analyse des menaces.