ADVERTISEMENT

DiscGolfScores tarjoaa muille sovelluksille (etenkin mobiili) rajapinnan, jonka avulla voi hyödyntää tulospalvelun tietoja ja tallentaa tulokset esimerkiksi suoraan kentältä.

Rajapinnan ominaisuudet on kuvattu dokumentissa http://discgolfscores.net/docs/DiscGolfScores-API.pdf ja tässä osoitteessa pidetään tallessa aina rajapinnan viimeisimmän version tietoja.

Tässä ketjussa puolestaan voi esittää rajapintaan liittyviä kysymyksiä ja ylläpito puolestaan ilmoittelee rajapintaan kohdistuvista muutoksista.

Viime aikoina rajapintaan on tehty paljon muutoksia, joten hypättäessä versioon 0.7 tehtiin myös erillinen "Release Notes" eli julkaisuilmoitus. Se löytyy osoitteesta http://discgolfscores.net/docs/DiscGolfScores-API-v0.7.0-ReleaseNotes.pdf.

Ja nyt uusin versio on jo 0.7.1, jossa edelliseen verrattuna on lisätty ratojen hakuun lisää ratojen eri layoutteja koskevaa informaatiota.

Rajapintaan tehty pieni päivitys. Nyt apiLogin funktio palauttaa suosikkiratojen tiedot samalla tavalla kuin apiSearchCourses:kin tekee.

Eli aiemmin oli näin:
<favorite_courses>
   <course>
      <id>272</id>
      <code>Karhumäki</code>
   </course>
   <course>
      <id>33</id>
      <code>Pikisaari DGP</code>
   </course>
<favorite_courses>

Ja nyt on näin:
<favorite_courses>
   <course>
      <id>272</id>
      <code>Karhumäki</code>
      <available_layouts>
         <course_layout>
            <id>172</id>
            <layout>Karhumäki</layout>
            <default>0</default>
            <number_of_fairways>9</number_of_fairways>
         </course_layout>
      </available_layouts>
   </course>
   <course>
      <id>33</id>
      <code>Pikisaari DGP</code>
      <available_layouts>
         <course_layout>
            <id>33</id>
            <layout>Pikisaari DGP</layout>
            <default>0</default>
            <number_of_fairways>9</number_of_fairways>
         </course_layout>
      </available_layouts>
   </course>
<favorite_courses>

Tarkoituksena siis tuoda tulosten lisäämisessä tarvittavat layouttien tiedot jo suosikkiratojen mukana, joten niitä ei tarvitse erikseen hakea.

Tuossa rakenteessa on nyt tuo <available_layouts> hieman turha välikerros, mutta pois ei viitsi ottaa, jos toteutuksia tehty jo sen mukaan.

Rajapintakuvauksen uusi versio julkaistaan hieman myöhemmin ja siinä tulee muitakin lisäyksiä kuin tämä.

Terveisin,
DGS Ylläpito

Rajapintadokumentaatiosta julkaistu uusi versio. Dokumentti löytyy tutusta paikasta eli osoitteesta http://discgolfscores.net/docs/DiscGolfScores-API.pdf.

ADVERTISEMENT