...
Для назначения водителей на автомобили по API используется структура application/xml и HTTP-метод POST.
URL: /rest/2/distribution-api/objects/assignPerformersToVehicles
Поддерживаемые атрибуты:
| № | Название поля | Обязательность | Описание |
| 1 | performerName | Да | Имя водителя |
| 2 | vehicleName | Да | Имя автомобиля |
| 3 | date | Нет | Дата, на которую водитель назначается на автомобиль. Дата не может быть указана в прошлом |
Пример запроса:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
<sessionID>545d1a3f6b2445019a369c9477c6dc36</sessionID>
<allocationsDetails>
<allocations>
<allocation performerName="Виктор Иванов" vehicleName="А 609 КМ" date="24.02.2016" />
</allocations>
</allocationsDetails>
</apiRequest> |
...
Пример ответа:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<apiResponse version="1.0">
<objects>
<updatedObject>
<name>Виктор Иванов - А 609 КМ</name>
</updatedObject>
</objects>
</apiResponse> |
Возможные ошибки:
| причина | ошибка |
1 | При указании некорректного sessionID | 1009 - "Provided credentials are invalid" |
2 | При вводе некорректного имени/id водителя | 1206 - "Performer is not found" |
3 | При вводе некорректного имени/id машины | 1304 - "Vehicle is not found" |
4 | При попытке назначить водителя на машинку из другого депо | 1234 - "Performer and vehicle have different areas of control" |
5 | При попытке назначить водителя, который имеет не уникальное имя в системе | 1302 - Found more then one performer with same name" |
6 | При попытке привязать водителя/машинку, связанных с ДС, на который у пользователя нет прав | 1019 - "User with provided credentials doesn't have AoC access or AoC doesn't exist" |
| 7 | При попытке задать прошлую дату | 1214 - "Invalid value for parameter: date has already passed" |
| 8 | При попытке назначить водителя с уже запланированным расписанием на другую машину. | 2028 - "The selected driver has allocated orders" |