API Просмотр таможенного XML

Материал из Alta-Soft Wikipedia
Версия от 18:16, 11 октября 2018; Krashennikova (обсуждение | вклад) (Новая страница: «==О сервисе== Сервис «Просмотр таможенного XML» предоставляет разработчикам возможность а…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

О сервисе

Сервис «Просмотр таможенного XML» предоставляет разработчикам возможность автоматической конвертации файлов в XML-формате в их печатную форму в формате PDF из внешних программ и сайтов. С помощью данного сервиса возможно визуализировать все типы файлов, пересылаемых по системе ЭД-2 или передаваемых в таможенные органы на электронном носителе информации.

API

Доступ к API предоставляется по URL https://www.alta.ru/xml-preview/api/. Для использования сервиса необходима авторизация с помощью логина и пароля.

Для авторизации с помощью пары логин/пароль необходимо отправлять POST-запрос по URL, содержащий следующие GET-параметры:
логин в открытом виде,
секрет - MD5-хеш от сгенерированной строки размер_файла в байтах + логин + md5-хэш от пароля, разделенный знаком двоеточия «:».
Например, для пользователя с логином testlogin и паролем testpassword вычисляем секрет для тестового файла: secret = md5("28129:testlogin:md5(testpassword)") = 8a4ba8b265e827b14e46ba394e99653b

Таким образом итоговый URL, на который совершается POST-запрос: https://www.alta.ru/xml-preview/api/?login=testlogin&secret=8a4ba8b265e827b14e46ba394e99653b

Файл формата XML отправляется вложением "multipart/form-data" с произвольным именем файла (например можно использовать file), или POST данными "application/xml" (на выбор разработчика).


Для тестового подключения и предварительной настройки используйте:
логин: testlogin
пароль: testpassword
В качестве файла можно передавать только тестовый файл (во вложении)



Ниже приводится полный список входных параметров:

Параметр Тип Описание
login GET string Логин к сервису
secret GET string MD5-секрет для данного запроса
file POST Xml Вложенный xml файл с любым именем (например file), или post data application/xml

В случае успешной обработки данных в ответ возвращается файл в формате PDF, код ответа сервера – 200.

При возникновении ошибок возвращается код ответа сервера 401, а также код ошибки в JSON-массиве.