get_driver_bindings
Чтобы получить информацию о назначениях и снятиях водителей за указанный интервал, используйте метод resource/get_driver_bindings.
Конечная точка
svc=resource/get_driver_bindings¶ms={
"resourceId": <long>,
"unitId": <long>,
"driverId": <long>,
"timeFrom": <uint>,
"timeTo": <uint>
}
Этот метод возвращает компактный список времен назначения и снятия с соответствующими ID объектов. В зависимости от конфигурации сервера он может использовать те же данные событий назначений водителей, что и методы
events, но его ответ ограничен полямиtиu. Чтобы получить полные данные событий, используйте детекторresource_driversс методами events/load и events/get. Чтобы получить текущее состояние назначения, используйте events/get_last.
Метод относится к ресурсоемким запросам, поэтому на него распространяется ограничение на количество одновременно обрабатываемых ресурсоемких запросов в одной сессии. При превышении ограничения возвращается ошибка 1003 с причиной
LIMIT api_concurrent. Список ресурсоемких запросов см. в разделе Ограничения.
Параметры
| Параметр | Описание |
|---|---|
resourceId |
ID ресурса. |
unitId |
ID объекта. Используйте 0 для всех объектов. |
driverId |
ID водителя. Используйте 0 для всех водителей. |
timeFrom |
Начало интервала. |
timeTo |
Конец интервала. |
Ответ
{
"<text>": [ /* ID водителя */
{
"t": <uint>, /* время назначения/снятия */
"u": <long> /* ID объекта в случае назначения, 0 в случае снятия */
},
...
],
...
}
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Не удалось получить список водителей или неверные входные параметры. |
| 5 | События для ресурса отключены или инициализируются. Поле reason содержит EVENTS_ARE_DISABLED или EVENTS_ARE_INITIALIZING соответственно. В Wialon Local эта ошибка может возвращаться начиная с версии 2504. |
| 7 | Нет права Запрос сообщений и отчетов или Просмотр водителей на ресурс; нет права Просмотр элемента и его основных свойств на объект; или ресурс, объект, водитель либо сервис событий недоступны. |