Contacts list
Contact Info
Contact activity
Me
Places
contact/{id}/activity
Получить список активности
GET /api/v1/contacts/{id}/activity
Данный метод возвращает список запросов и ответов между двумя пользователями(мной и выбранным контактом).
Если поле position пустое, то это пользователь сделал запрос, в обратном случае - отправил свою позицию.
Поле incoming (true/false) дает понять от кого пришла позиция или запрос (true - мне прислали, false - я отправил).
Параметры:
limit (optional) | Число элементов, отдаваемых за раз (по умолчанию 10). |
page (optional) | Номер страницы (1,2,...) |
Пример ответа
{
"data":
[
{
"time":"2012-01-24T20:34:54Z",
"position":{
"latitude":60.0479,
"longitude":30.3391,
"radius":65,
"address":"ул. Есенина, 26, СПб, Россия",
"time":"2012-01-24T20:34:54Z"
},
"incoming":true
},
{
"time":"2012-01-24T20:33:36Z",
"incoming":false
},
{
"time":"2012-01-24T17:21:55Z",
"position":{
"latitude":59.9683,
"longitude":30.3045,
"radius":76,
"name":"Дома",
"address":"Ординарная ул., 20, СПб, Россия",
"picture":"http://gdeseychas.s3.amazonaws.com/images/u1/yr86kzh4ra.jpg",
"time":"2012-01-24T17:21:55Z"
},
"incoming":false
},
{
"time":"2012-01-24T15:28:20Z",
"incoming":false
}
]
}
Отправить запрос "Где ты?"
POST /api/v1/contacts/{id}/activity
Параметров нет.
Отправить местоположение (checkin)
POST /api/v1/contacts/{id}/activity
Если передаются параметры местоположения (latitude,longitude или placeId), то будет отправлена позиция. В обратном случае (никаких координат не передается) контакту будет отправлен запрос.
Параметры:
latitude, longitude (required) |
Широта и долгота. |
radius (optional) | Точность местоположения. Необходимо передавать если пользователь отправляет свое текущее вычесленное телефоном местоположение. |
placeId (optional) |
Id метки пользователя (см. GET /places). Контакту будет отправлено местоположение в данном месте (в этом случае параметры latitude и longitude не учитываются). |
name (optional) | Название метки/места (например "м. Черная речка"). |
comment (optional) |
Уточняющий комментарий. Не боллее 30 символов. Например: "Выхожу", "Подьехал", "Стою в пробке". |
image (optional) | Фото прикрепленное к позиции, размером не более 1024x768, пропорции любые. (Формат: Base64) |
live (optional) | Время жизни позиции в миллисекундах (не более 3 часов) - "Живая метка". |
arrival_latitude, arrival_longitude (optional) | Место прибытия при отправке живой метки. |
type (optional) | Тип уведомления: 'noalert' - без Push-уведомления, 'nohistory' - без занесения в историю и без уведомления. По умолчанию с тем и другим. |
Пример ответа
{
"data":[
{
"time":"2012-01-24T17:21:55Z",
"position":{
"latitude":59.9683,
"longitude":30.3045,
"radius":50,
"address":"Ординарная ул., 20",
"time":"2012-01-24T17:21:55Z"
},
"incoming":false
}
]
}
Если предыдущий запрос был выполнен не поздее чем 3 минуты назад, то при повторном запросе будет возвращена ошибка:
{
"error":{
"message":"JustRequestException",
"code":1601
}
}
Удаление записи из истории
DELETE /api/v1/contacts/{id}/activity/{itemId}
Запись удаляется для того кто ее удаляет. После удаления записи обоими контактами - она полностью удаляется из базы.