Просмотр кода страницы API онлайн-сервиса Подбор кода

==О сервисе==
Сервис «Подбор кода» является алфавитно-предметным указателем, позволяющим сопоставить наименование товара с конечным кодом ТН ВЭД. 

Определение кода происходит в два этапа:

*Получение списка подсказок-словосочетаний по введенному слову
*Получение кодов ТН ВЭД по выбранному словосочетанию

При выдаче подсказок и кодов ТН ВЭД записи отсортированы с учетом вероятности, от максимальной к минимальной.

==API==
Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml_apu/ 

Входные параметры передаются с помощью запроса HTTP GET. 
===Получение списка подсказок, а также идентификаторов подсказок и наборов подходящих групп ТН ВЭД===
Для получения списка подсказок, а также идентификаторов подсказок и наборов подходящих групп ТН ВЭД, необходимо в GET-запросе передать параметр q, содержащий искомый текст.

Пример запроса: https://www.alta.ru/tnved/xml_apu/?q=пилы

Для получения определенного количества подсказок необходимо передать GET-параметр limit. Возможные значения: -1 (неограниченное количество подсказок) или любое положительное число.

XML-ответ:
{| class="wikitable" width="75%"
|-
|result||Корневой элемент документа
|-
|line||Элемент с информацией о подсказке
|-
|term||Текст подсказки
|-
|tngroup||Набор подходящих групп ТНВЭД
|-
|payload||Идентификатор подсказки
|-
|weight||Приоритет подсказки
|-
|}

===Получение списка кодов ТН ВЭД и весов===
Для использования сервиса с целью получения списка кодов ТНВЭД и весов по идентификатору подсказки необходима авторизация с помощью сервисного логина и пароля.
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Идентификатор подсказки + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
для запроса: https://www.alta.ru/tnved/xml_apu/?code=112675973&login=testlogin    <br>
вычисляем секрет: secret = md5("112675973:testlogin:md5(testpassword)")<br>
итоговый URL: https://www.alta.ru/tnved/xml_apu/?code=112675973&login=testlogin&secret=8d43448578371c8a247c82223014e9a0 

----
<code>
Для тестового подключения и предварительной настройки используйте:<br>
логин: '''testlogin'''<br>
пароль: '''testpassword'''<br>
Для тестового пользователя доступны идентификаторы подсказок: 112675973, 114886448
</code>
----
Пример запроса: https://www.alta.ru/tnved/xml_apu/?code=112675973&login=testlogin&secret=8d43448578371c8a247c82223014e9a0 

Для получения определенного количества кодов необходимо передать GET-параметр limit. Возможные значения: -1 (неограниченное количество подсказок) или любое положительное число.

XML-ответ:
{| class="wikitable" width="75%"
|-
|result||Корневой элемент документа
|-
|line||Элемент с информацией о подсказке
|-
|tnved||Код ТН ВЭД
|-
|weight||Вес кода. Чем больше вес, тем больше вероятность, что это подходящий код.
|-
|descr||Наименование ТН ВЭД
|-
|descr_sh||Описание ТН ВЭД
|-
|tncode||Код ТН ВЭД в формате NNNN NN NNN N
|-
|}

==Ошибки==
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br>
При работе с сервисом возможны следующие ошибки:

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|120||Ошибка тарификации
|-
|200||Не указана строка или код поиска
|-
|200||Нет информации
|-
|201||Указан нулевой лимит при запросе
|}


==Примеры ошибок==
Пользователь не авторизован:<br>
https://www.alta.ru/tnved/xml_apu/?code=114886448&login=testlogin&secret=8d43448578371c8a247c82223014e9a0

Лимит запросов для данного пользователя исчерпан:<br>
https://www.alta.ru/tnved/xml_apu/?code=114886448&login=testloginlimit&secret=1120a0a9187217ac2ab6d3f0acec0a86

Не указана строка или код поиска:<br>
https://www.alta.ru/tnved/xml_apu/

Указан нулевой лимит при запросе:<br>
https://www.alta.ru/tnved/xml_apu/?code=114886448&login=testlogin&secret=4c83f2d0a098d36406b98765181a549c&limit=0

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:Такса]]