...
# | Название атрибута | Тип | Обязательность | Описание | ||
1 | sessionID | Текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. | ||
2 | date | Дата | Да | Дата, на которую назначен(ы) рейс(ы). | ||
3 | vehicleExternalID | Текст | Нет | Если указан, то отошлются только рейсы, назначенные на данную машину. | ||
4 | driverExternalID | Текст | Нет | Если указан, то отошлются только рейсы, назначенные на данного водителя. | ||
5 | dcName | Текст | Нет | Если указан, то отошлются только рейсы для данного РЦ. | ||
6 | runNumber | Число | Нет | Если указан, то отошлется только выбранный рейс. |
...
В запросе возможны следующие комбинации атрибутов:
Отправка рейсов для всех РЦ данного аккаунта: sessionID + date;
Sending runs of a certain DC: sessionID + date + dcName;
Sending runs of a certain vehicle: sessionID + date + vehicleExternalID;
Sending runs of a certain driver: sessionID + date + driverExternalID;
Sending a certain run of a certain vehicle: sessionID + date + vehicleExternalID + runNumber;
Sending a certain run of a certain driver: sessionID + date + driverExternalID + runNumber.
Примечание Указание сразу нескольких атрибутов приводит к избыточности (кроме случая vehicleExternalI/driverExternalID + runNumber), и система отреагирует на это ошибкой (1020 "Redundant parameters" - Избыточные параметры). См. перечень возможных ошибок ниже.
...
Ошибка | Описание | Описание |
---|---|---|
1009 | Invalid or unknown session ID | Недействительный или неизвестный идентификатор сессии |
1013 | Date in incorrect format | Некорректный формат даты |
1014 | Expected parameter not provided | Ожидаемый параметр не представлен |
1015 | Internal service error | Внутренняя ошибка |
1020 | Redundant parameters | Избыточные параметры |
1202 | Area of control is not found | Не найдены распределительные центры |
1206 | Performer is not found | Водитель не найден |
1304 | Vehicle is not found | Машина не найдена |
Пример ошибки
|