Места
Список мест
GET /places
Структура запроса:
GET /places?token=puqw129npc074a
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"id": 81,
"name": "Место",
"geom": {
"type": "Point",
"coordinates": [49.1793,
55.7727]
},
"address": "Татарстан, Казань, Гвардейская улица, 53А",
"radius": 150.0
},…]
Добавление места
POST /places
Структура запроса:
POST /places?token=puqw129npc074a
token: ключ доступа
Пример запроса:
Статус: 200 — успешное выполнение
Формат: json
{
"address": "Москва, Таганская площадь, 86/1",
"geom": {
"type": "Point",
"coordinates": [37.65233516693115,
55.741462725687825]
},
"name": "Новое место",
"radius": "120"
}
// адрес, строка
// информация о геометрии
// тип геометрии, строка
// координаты
// название места, строка
// радиус, число с плавающей точкой
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 262,
"name": "Новое место",
"geom": {
"type": "Point",
"coordinates": [37.6523,
55.7415]
},
"address": "Москва, Таганская площадь, 86/1",
"radius": 120.0
}
// id места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты
// адрес, строка
// радиус, число с плавающей точкой
Информация о месте по ID
GET /places/id
Структура запроса:
GET /places/132?token=puqw129npc074a
id: id места
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 132,
"name": "Место",
"geom": {
"type": "Point",
"coordinates": [49.1793,
55.7727]
},
"address": "Татарстан, Казань, Гвардейская улица, 53А",
"radius": 213.0
}
// id места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты
// адрес, строка
// радиус, число с плавающей точкой
Информация о месте по ID и дате
GET /places/id/events
Структура запроса:
GET places/132/events?dateFrom=1430859600000&dateTo=1430920123215?token=puqw129npc074a
id: id места
dateFrom: дата начала
dateTo: дата конца
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"userId": 86,
"date": 1430254847000,
"inside": false
},...]
// id пользователя, целое число
// дата события, timestamp
// находится в пределах указанного места, булева переменная
Редактирование места
PUT /places/id
Структура запроса:
PUT /places/262?token=puqw129npc074a
id: id места
token: ключ доступа
Пример запроса:
Статус: 200 — успешное выполнение
Формат: json
{
"address": "Москва, улица Рогожский Вал, 8",
"geom": {
"type": "Point",
"coordinates": [37.6747,
55.7413]
},
"name": "Новое место",
"radius": 500
}
// адрес, строка
// информация о геометрии
// тип геометрии, строка
// координаты
// название места, строка
// радиус, число с плавающей точкой
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 262,
"name": "Новое место",
"geom": {
"type": "Point",
"coordinates": [37.6747,
55.7413]
},
"address": "Москва, улица Рогожский Вал, 8",
"radius": 500.0
}
// id места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты
// адрес, строка
// радиус, число с плавающей точкой
Удаление места
DELETE /places/id
Структура запроса:
DELETE /places/262?token=puqw129npc074a
id: id места
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
{
"id": 262
}
Возможные статусы ответов сервера при ошибке:
Статус: 401 — необходима авторизация
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 403 — доступ запрещен
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 404 — не найдено
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки