Popis api na geocaching.cz
Parametry api se předávají pomocí post nebo get parametrů. Parametr a představuje volanou funkci api.
Formát výstupu
akce:{název volané funkce}
info:OK|CHYBA:{popis chyby}
data:{výstupní data, pokud nějaká jsou}
Nastavení nálezů
Nálezy se využívají pro v kešmapě, nebo pro generování mapy nálezů
Parametry
- a
- nalezy
- u
- uživatelské jméno na geocaching.cz
- p
- heslo na geocaching.cz
- d
- data
Formát dat
{waypoint};{datum};{lat};{lon}|{waypoint};{datum};{lat};{lon}|...
Datum je ve formátu yyyy-mm-dd
Čtení vlastních nálezů nálezů
přečtení vlastních nálezů
Parametry
- a
- ctivlastninalezy
- u
- uživatelské jméno na geocaching.cz
- p
- heslo na geocaching.cz
- v
- verze (aktuálně 1)
Příklad
Čtení obsahu bestof bookmarků
čtení počtu výskytů kešek ve vybraných bestof bookmarcích
Parametry
- a
- ctibestof
- v
- verze (aktuálně 1)
Formát výstupních dat
{waypoint};{počet výskytů}|{waypoint};{počet výskytů}|...
Příklad
Ohodnocení kešky
Nastavit hodnocení kešek
Parametry
- a
- hodnoceni
- u
- uživatelské jméno na geocaching.cz
- p
- heslo na geocaching.cz
- v
- verze (aktuálně 1)
- d
- data
Formát dat
{waypoint};{hodnocení}|{waypoint};{hodnocení}|...
Přípustná hodnocení: 0,12,25,37,50,62,75,87,100
Čtení hodnocení
Přečte ze serveru průměrná hodnocení kešek
Parametry
- a
- ctihodnoceni
- v
- verze (aktuálně 1 nebo 2)
- d
- jaký minimální počet hodnocení musí keška mít, aby bylo vráceno její hodnocení. Nepovinný parametr. Pokud není uvedena číselná hodnota, může tento parametr obsahovat čárkou oddělené waypointy, jejichž hodnocení má být přečteno
Formát výstupních dat verze 1
{waypoint};{průměrné hodnocení};{počet hodnocení}|{waypoint};{průměrné hodnocení};{počet hodnocení}|...
Formát výstupních dat verze 2
{waypoint};{průměrné hodnocení};{počet hodnocení};{vážený průměr};{rozptyl}|{waypoint};{průměrné hodnocení};{počet hodnocení};{vážený průměr};{rozptyl}|...
Formát výstupních dat verze 3
{waypoint};{průměrné hodnocení};{počet hodnocení};{vážený průměr};{rozptyl}|{waypoint};{průměrné hodnocení};{počet hodnocení};{vážený průměr};{rozptyl};{rozptyl2}|...
Příklad
Čtení vlastních hodnocení
Parametry
- a
- ctivlastnihodnoceni
- u
- uživatelské jméno na geocaching.cz
- p
- heslo na geocaching.cz
- v
- verze (aktuálně 1)
Příklad
Převod wpt na guid
Parametry
- a
- wpt2guid
- v
- verze (aktuálně 1)
- d
- seznam wpt oddělené čárkou
Formát výstupních dat verze 1
{wpt};{guid}|{wpt};{guid}|...
Nenalezené wpt není ve výstupu vůbec uvedeno
Příklad
Převod guid na wpt
Parametry
- a
- guid2wpt
- v
- verze (aktuálně 1)
- d
- seznam guid oddělené čárkou
Formát výstupních dat verze 1
{guid};{wpt}|{guid};{wpt}|...
Nenalezené wpt není ve výstupu vůbec uvedeno
Příklad