Получение показаний датчиков через API
Примечание
Работа через API доступна только пользователю с ролью Администратор в сервисе Маршрутизации.
Чтобы получать информацию о температурных датчиках через API, запросы к сервису должны быть подписаны и содержать параметр apikey
для аутентификации. Подробнее см. в разделе Ключ API.
Для просмотра значения датчиков по маршруту используйте метод sensor-values
.
GET https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/routes/<id-маршрута>/sensor-values?apikey=[APIKEY]
В ответе приходит отчет о температурном режиме.
Ответ на GET-запрос
{
"next_page_token": <токен следующей страницы>,
"results": [
{
"imei": <IMEI датчика>,
"values": [ # список показаний датчика, отсортированный по дате и времени
{
"time": <время в формате UNIX>,
"value": <значение температуры>,
},
"metadata": {
"timestamp_from": <начало интервала значений в ответе в формате UNIX>,
"timestamp_to": <конец интервала значений в ответе в формате UNIX>,
},
"sensor": { # датчик
"number": <номер датчика>,
"name": <наименование датчика>
},
]
}
Чтобы запросить следующую часть отчета, передайте в параметре page_token
значение next_page_token
, полученное в предыдущем ответе:
GET courier.yandex.ru/api/v1/companies/<id-вашей-компании>/routes/<id-маршрута>/sensor-values?page_token=[TOKEN]&apikey=[APIKEY]
Если следующей страницы в отчете нет, придет пустой ответ.
Была ли статья полезна?
Предыдущая
Следующая