API za popis geozona namijenjen je za ispis informacija o korisnikovim geozonama (sve vidljive geozone: koje je kreirao korisnik i koje su podijeljene s korisnikom).
Struktura zahtjeva:
GET /geozones?api_key= <...>&version=1&limit= <...>&continuation_token= <...>HTTP/1.1
Domaćin: api.fm-track.com
Vrsta sadržaja: application/json; charset=UTF-8
Parametri zahtjeva:
| Parameter | Type | Description | Required |
|---|---|---|---|
| api_key | String | User identification key | Yes |
| version | Integer | API version | Yes |
| limit | Integer | Limits geozones count in response | No |
| continuation_token | Integer | Displays from what date and time the data is shown if the record limit was reached | No |
Primjer odgovora:
{
"continuation_token": 1,
"items": [
{
"id": "d4e18901",
"name": "asdada",
"notes": "aaa fff",
"type": "POINT",
"circle": {
"latitude": 54.689538538142585,
"longitude": 25.270938071441606,
"radius": 250.0
}
},
...
]
}Ako je parametar netočno unesen, sustav će odgovoriti kodom pogreške. Svi kodovi pogrešaka opisani su u odjeljku API-ji . Parametri za koje nisu navedeni podaci nisu uključeni u odgovor. Potpuni popis parametara odgovora dostupan je na kraju ovog odjeljka.
Parametri odgovora:
| Parameter | Type | Description |
|---|---|---|
| continuation_token | Integer | Continuation token is sent when number of geozones in response exceed limit |
| items | Array | Container for all user geozones |
| id | String | External geozone ID |
| name | String | Geozone name |
| notes | String | Geozone notes |
| type | Enum | Geozone type. There are two types: point and polygon |
| circle | Array | Container for point information. If it is a polygon type, this parameter will be NULL |
| latitude | Double | Latitude of point center |
| longitude | Double | Longitude of point center |
| radius | Double | Radius in meters |