Jeżeli interesuje cię publikowanie danych dotyczących zawodów np. na tablicy z wynikami lub w relacji wideo, możesz skorzystać z pliku tekstowego, który zawiera wszystkie informacje o zawodach. Listy startowe i wyniki w formie pliku CSV (dla wszystkich lub jednej konkurencji) można pobrać w dowolnym momencie przed, w trakcie lub po zakończeniu zawodów. Można zrobić to ręcznie lub automatycznie. 


Przykładowe skrypty automatyzujące ten proces są dostępne do pobrania na końcu tego dokumentu (.bat dla Windows, .sh dla Linux/Mac).


Pliki CSV z listą startową i wynikami można pobrać w widoku Szczegóły zawodów, klikając przycisk Import/Eksport  i wybierając Eksport list startowych lub Eksport wyników.


 

W załącznikach (na dole strony) dostępne są dwa przykładowe pliki CSV z listą startową i wynikami.


Możesz także zautomatyzować proces pobierania plików. Wymaga to jednak wcześniejszej konfiguracji.


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 '[email protected]&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 meet/meeting 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):




Lista kontrolna przy pracy z API


Jeżeli masz problem z dostępem do plików poprzez API, upewnij się, że:

  • Posiadasz połączenie z internetem,
  • ID zawodów jest poprawne,
  • Masz uprawnienia do przeglądania lub edytowania zawodów,
  • Używasz najnowszej wersji skryptu, który zawiera aktualną wersję domeny,
  • Liczba kolumn w plikach CSV z listami startowymi i wynikami nie jest stała i zależy od rodzaju zawodów oraz dodanych konkurencji.
  • Jeżeli po uruchomieniu skryptu pojawi się komunikat o błędzie „The revocation function was unable to check revocation for the certificate”, Twoje oprogramowanie antywirusowe może blokować operację. Aby rozwiązać ten problem, dodaj api.admin.rosterathletics.com do listy witryn, które program wykluczy ze skanowania zagrożeń.