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

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

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

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

или

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

:!: Для "callMode":"say","read" команда может использоваться с "sid".
:!: Водитель должен быть назначен на объект.

Просмотр статуса объекта, на который назначен водитель

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

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

{"un":{ /* параметры объекта */
	"nm":<text>, 
	"cls":<uint>,     
	"id":<uint>,    
	"mu":<uint>,
	"pos":{ ... },
	"lmsg":{ ... },
	"uri":<text>,
	"ugi":<uint>,
	"uacl":<int>
	},
"drv":{ /* параметры водителя */
	"nm":<text>},
"uh":<text> /* зашифрованная информация об устройстве (для WiaTag) */
}

:!: Описание остальных параметров и содержимое "pos", "lmsg" доступно в статье Объекты

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

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

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

svc=resource/driver_operate&params={"phoneNumber":<text>,
				    "password":<text>,
				    "callMode":"say",
				    "message":<text>,
				    "timeSend":<uint>
				    }

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

svc=resource/driver_operate&params={"resourceId":<uint>,
				    "driverId":<uint>,
				    "callMode":"say",
				    "message":<text>,
				    "timeSend":<uint>
				    }

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

{
	"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>,
			"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