MapIssues — rest — places

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
},…]



// id места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты


// адрес, строка
// радиус, число с плавающей точкой

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 места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты


// адрес, строка
// радиус, число с плавающей точкой


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 места, целое число
// название места, строка
// информация о геометрии
// тип геометрии, строка
// координаты


// адрес, строка
// радиус, число с плавающей точкой

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
Содержит описание ошибки