Водители: управление

Для управления водителями используется команда resource/driver_operate:

:!: Возможность использования следующих callMode будет отменена:

get_message_file, order_reject, order_confirm, order_attachments, order_get_attachment

Для авторизации можно использовать связку:

	"phoneNumber":<text>, /* номер телефона водителя */
	"password":<text>     /* пароль водителя */

или

	"phoneNumber":<text>, /* номер телефона объекта */
	"password":<text>     /* пароль объекта */

:!: Для "callMode":"say","read" команда может использоваться с "sid".
:!: Номер телефона подается в международном формате «+xxxxxxxxxxxx». «+» должен быть энкодирован «%2B». :!: Водитель должен быть назначен на объект.

Послать сообщение водителю

:!: Можно прикреплять файлы используя multipart/form-data

Без использования sid

svc=resource/driver_operate&params={"phoneNumber":<text>,
				    "password":<text>,
				    "callMode":"say",
				    "message":<text>,
				    "timeSend":<uint>,
				    "appId":<text>, /* id приложения для push уведомления */
				    "appType":<text> /* тип приложения для push уведомления */
				    }

С использованием "sid"

svc=resource/driver_operate&params={"resourceId":<uint>,
				    "driverId":<uint>,
				    "callMode":"say",
				    "message":<text>,
				    "timeSend":<uint>,
				    "ej":<JSON> /* произвольный JSON */,
				    "appId":<text>, /* id приложения для push уведомления */
				    "appType":<text> /* тип приложения для push уведомления */
				    }

Возвращаемый результат

{
	"tm":<uint>   /* время */ 
} 

Посмотреть сообщения от водителя

Без использования sid

svc=resource/driver_operate&params={"phoneNumber":<text>,
				    "password":<text>,
				    "callMode":"read",
				    "timeFrom":<uint>,
				    "timeTo":<uint>
				    }

С использованием "sid"

svc=resource/driver_operate&params={"resourceId":<uint>,
				    "driverId":<uint>,
				    "callMode":"read",
				    "timeFrom":<uint>,
				    "timeTo":<uint>
				    }

Возвращаемый результат

[
	{
		"t": <time>,
		"f": <uint>,
		"tp": <text>,
		"p": {
			"flags": <uint>,
			"text":<text>,
			"time_send":<uint>,
			"ej":"<JSON>",
			"files": {
				<text>:<uint> /* имя файла:id файла */ 
			}
		}
	},
	...
]

:!: Описание параметров доступно в статье Сообщения

Получить список заявок

svc=resource/driver_operate&params={"phoneNumber":<text>,
				    "password":<text>,
				    "callMode":"orders_list"
				    }

Возвращаемый результат

[
	{
		"id":<​uint>,
		"n":<​text>,
		"f":<​uint>,
		"tf":<​uint>,
		"tt":<​uint>,
		"trt":<​uint>,
		"uid":<​uint>,
		"r":<​uint>,
		"y":<​double>,
		"x":<​double>,
		"u":<long>,
		"s":<​uint>,
		"sf":<​uint>,
		"st":<​uint>,
		"cnm": <uint>,
		"p": {
			"ut":<​uint>,
		...
		}
	},
	...
]

:!: Описание параметров доступно в статье Работа с заявками

Отклонить заявку

:!: Можно прикреплять файлы используя multipart/form-data

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"order_reject",
			     "id":<uint>
			     }

Возвращаемый результат

{
	error: 0, /* в случае успеха */
}

Подтвердить заявку

:!: Можно прикреплять файлы используя multipart/form-data

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"order_confirm",
			     "id":<uint>
			     }

Возвращаемый результат

{
	error: 0, /* в случае успеха */
}

Пометить сообщение от водителя

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"mark_message",
			     "message":<text>,
			     "time":<uint>,
			     "flags":<uint>
			     }

Возвращаемый результат

{
	error: 0, /* в случае успеха */
}

Получить фотографию из сообщения водителя

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"get_message_file",
			     "fileId":<text>
			     }

:!: fileId можно получить используя callMode:read

Возвращаемый результат

Возвращает изображение.

Получить список вложений заявки

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"order_attachments",
			     "id":<text>                     /* ID заявки */
			     }

Возвращаемый результат

[
  {
   "n":<text>,   /* имя файла */
   "s":<uint>,   /* размер файла */
   "ct":<uint>,  /* время создания файла */
   "mt":<uint>   /* время изменения файла */
  }
]

Получить вложение заявки

svc=resource/driver_operate={"phoneNumber":<text>,
			     "password":<text>,
			     "callMode":"order_get_attachment",
			     "id":<text>,                        /* ID заявки */
			     "path":<text>                       /* имя файла вложения */
			     }

Возвращаемый результат

Возвращает файл вложения.
Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2024 Gurtam