Frisbeegolf-forum.fi

Author Topic: DiscGolfScores API rajapinta  (Read 13699 times)

Offline DGS Ylläpito

  • Tomoottajat
  • Täysjäsen
  • *
  • Posts: 120
    • View Profile
DiscGolfScores API rajapinta
« on: 10.03.12 - klo:21:52 »
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.

Offline DGS Ylläpito

  • Tomoottajat
  • Täysjäsen
  • *
  • Posts: 120
    • View Profile
Vs: DiscGolfScores API rajapinta
« Reply #1 on: 10.03.12 - klo:21:54 »
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.

Offline DGS Ylläpito

  • Tomoottajat
  • Täysjäsen
  • *
  • Posts: 120
    • View Profile
Vs: DiscGolfScores API rajapinta
« Reply #2 on: 10.04.12 - klo:21:10 »
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

Offline DGS Ylläpito

  • Tomoottajat
  • Täysjäsen
  • *
  • Posts: 120
    • View Profile
Vs: DiscGolfScores API rajapinta
« Reply #3 on: 20.05.12 - klo:20:49 »
Rajapintadokumentaatiosta julkaistu uusi versio. Dokumentti löytyy tutusta paikasta eli osoitteesta http://discgolfscores.net/docs/DiscGolfScores-API.pdf.