Saját műhódot mindenkinek! GPSGames XML API 0.46
Játék adatok kinyerése és adatok küldése az oldalra
Paraméterek:
- key [POST/GET] (string) - a saját kulcsod (string), ezt a gpsgames.hu üzemeletetőitől kérheted, egy az email címükre küldött levélben.
- action (string) - kérés típusa, lehetséges értékei:
- getgames [GET] - játékok listája
- getgamesbydistance [GET] - adott koordináta körüli játékok
- getgameslog [GET] - adott játék megtalálásai
- uservalidate [POST] - felhasználó beléptetése
- getuserdata [GET] - belépett felhasználó adatai
- userlogout [POST] - belépett felhasználó kiléptetése
- addlog [POST] - játék megtalálás rögzítése
Action -höz kapcoslódó további paraméterek:
- getgames
- type (int) - játék típusa ha nincs megadva akkor minden játék típust listáz, értékei:
- 1 - Kincskeresés
- 2 - Track követés
- 3 - Adventure
- 4 - Inverz-caching
- 5 - Térkép-olvasás
- 6 - Egyéb
- 7 - Indoor
- 8 - Csak semmi GPS!
- id (int)- adott játék id -je, ha nincs megadva akkor minden játékot listáz
- limit (int) - hány tétel listázódjon, max 50, ha nincs megadva, akkor az értéke 50
- offset (int) - hanyadik tételtől listázódjon, ha nincs megadva, akokr az értéke 0
- user_id (int) - adott user játékai, ha nincs megadva akkor minden user játékát listázza
- getgamesbydistance
- lat* (double) - lat decimális formában (pl.: 47.4130833333)
- lon* - (double) lon decimális formában (pl.: 19.0911666667)
- limit (int) - hány tétel listázódjon max 50, ha nincs megadva, akkor az értéke 10
- user_id (int) vagy token (string) - adott user nem megtalált játékai
- getgameslog
- id* (int) - adott játék id -je
- limit (int) - hány tétel listázódjon, max 50, ha nincs megadva, akkor az értéke 10
- uservalidate
- user_nev* (string) - felhasználónév
- user_jelszo* (string) - jelszó
- user_email (int) - felhasználói engedélyezés email lekérésre, értékei: (0/1) Fontos! A felhasználó figyelmét beléptetésekor fel kell hívni, hogy az email címe átadásra kerül, ha bejelöli az email opciót! Ha nem engeded választani, és hidden adatként állítod be, akkor is kell a figyelmeztető szöveg! Ha ezt nem tartod be, akkor a kulcsod letiltásra kerül.
- getuserdata
- addlog
- token* (string)
- jatek_id* (int) - adott játék id -je
- log_jelszo (string) - jelszó
- log_szoveg (string) - megjegyzés
- log_koord_1 (array) - lat gps formában (pl.: 47°46.969')
- log_koord_2 (array) - lon gps formában (pl.: 018°57.449')
Hibakódok
- -101 - érvénytelen token
- -102 - nem adott meg nevet és jelszót
- -103 - érvénytelen felhasználó név és/vagy jelszó
- -201 - nem adott meg játék id -t
Az action és a key minden esetben kötelező paraméter, a csillaggal jelöltek adott actionnél kötelezőek, a többi opcionális.
Példák:
Legfrisebb 15 játék minden kategóriából: https://gpsgames.hu/api/?key=sajatkulcs&action=getgames&limit=15
magpet játékai: https://gpsgames.hu/api/?key=sajatkulcs&action=getgames&user_id=3
Kincskeresés típusú játékok, 25 -össével listázva, a 3. oldal: https://gpsgames.hu/api/?key=sajatkulcs&action=getgames&type=1&limit=25&offset=75
(47.4130833333,19.0911666667) -tól 25 játék amit szg nem talát még meg: https://gpsgames.hu/api/?key=sajatkulcs&action=getgamesbydistance&lat=47.4130833333&lon=19.0911666667&limit=25&user_id=1
Működő pédák:
demó