import_messages

Для импорта сообщений из файла используйте команду exchange/import_messages.

Copied!
svc=exchange/import_messages&params={"itemId":<long>,
				     "eventHash":<text>}

Этот запрос нельзя выполнить одновременно в другими запросами из этого раздела, а также со следующими запросами:

Параметры

Обязательный параметр отмечен звездочкой (*).

Параметр

Описание

itemId*

ID элемента.

eventHash

Имя события, которое будет сгенерировано после импорта сообщений.

dontMarkImported

Если этот параметр имеет значение 1, импортированные сообщения будут отмечаться не как импортированные (imported), а как сообщения из черного ящика (blackbox); время регистрации может отличаться от времени сообщения. Если этот параметр отсутствует или имеет значение, отличное от 1, сообщения будут помечены как импортированные (imported).

Загрузка файла

Чтобы загрузить файл, используйте POST-запрос с множественным содержимым (multipart/form-data). Например:

Copied!
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_messages&sid=8157df114c0e601f0f31091c3c2ac53d
Request Method: POST
Connection: keep-alive
Content-Length: 2744
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarylvunQiir9AesO8qB
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Charset: windows-1251,utf-8;q=0.7,*;q=0.3
Accept-Encoding: gzip,deflate,sdch
Accept-Language: ru,en-US;q=0.8,en;q=0.6

------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="params"

{"itemId":898446,"eventHash":"jUploadForm1372773585167"}
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="eventHash"

jUploadForm1372773585167
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="messages_filter_import_file"; filename="4100.zip"
Content-Type: application/zip


------WebKitFormBoundarylvunQiir9AesO8qB--

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

При успешном выполнении запроса возвращается пустая строка.

Copied!
{ }	

Чтобы убедиться, что сообщения были импортированы, используйте команду …/requests/avl_evts.

Copied!
{
	"tm": <uint>,	/* текущее время сервера (UTC) */
	"events": [{
		"i": -1,
		"d": {			/* данные */
		"hash": <text>,		/* загрузка завершена */
		"msgCount": <text>	/* количество импортированных сообщений */
        }]
}

Если запрос выполнить не удалось, возвращается код ошибки.

Коды ошибок

КодОписание
1Неверный или устаревший SID запроса.
4Нет прикрепленных файлов.
6Внутренняя ошибка.
7

Одна из следующих ошибок:

  • не удалось получить данные о пользователе,
  • объект не найден,
  • не удалось получить объект, на который есть необходимое право доступа (ADF_ACL_AVL_UNIT_IMPORT_MSGS).
Скачать файл PDF
Скачать документ Word

Смотрите также