API онлайн-сервиса Товары и Коды - История изменений

Admin: Admin переименовал страницу API-XML для ТиК онлайн в API онлайн-сервиса Товары и Коды без оставления перенаправления

2022-03-25T16:07:05Z

Admin переименовал страницу API-XML для ТиК онлайн в API онлайн-сервиса Товары и Коды без оставления перенаправления

Admin: Admin переименовал страницу XML-API для ТиК онлайн в API-XML для ТиК онлайн без оставления перенаправления

2022-03-25T14:37:42Z

Admin переименовал страницу XML-API для ТиК онлайн в API-XML для ТиК онлайн без оставления перенаправления

Krashennikova в 02:04, 30 июля 2019

2019-07-30T02:04:52Z

Krashennikova в 17:35, 22 января 2019

2019-01-22T17:35:23Z

Krashennikova в 21:47, 20 марта 2018

2018-03-20T21:47:59Z

Krashennikova в 21:46, 20 марта 2018

2018-03-20T21:46:13Z

Krashennikova в 16:15, 23 ноября 2017

2017-11-23T16:15:25Z

Krashennikova в 16:11, 23 ноября 2017

2017-11-23T16:11:36Z

Krashennikova: Новая страница: «==О сервисе== XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонни…»

2017-11-23T16:07:56Z

Новая страница: «==О сервисе== XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонни…»

Новая страница

==О сервисе==
XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонние программы и сайты.

По искомому слову или словосочетанию сервис выдает список кодов ТН ВЭД и 100 первых записей по каждому коду, имеющих данное вхождение.

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

==API==
Доступ к API предоставляется по URL https://www.alta.ru/tik/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля, либо доступ может быть предоставлен по статичному IP-адресу.

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin
Вычисляем секрет: secret = md5("зерно:testlogin:testpassword")
Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

'''Для авторизации по статическому IP-адресу''' никакой дополнительной информации, кроме запроса, передавать не нужно. Запрос будет выглядеть как https://www.alta.ru/tik/xml/?srchstr=зерно

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр !!Тип !!Описание

|- highlight
|colspan=3 |'''Обязательные'''

|-
|srchstr||string||Слово или словосочетание; от 3-х букв

|- highlight
|colspan=3 |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|tncode||string||Код ТН ВЭД; от 2 до 10 цифр для ограничения поиска по подразделам, группам, подгруппам и т.п.

|-
|page||int||Номер страницы при дополнительном запросе данных по определенному коду; от 2

|}

==Примеры запросов==
Подбор кодов по словосочетанию: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

Дополнительные записи по словосочетанию и коду 1104291700: 
https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

==XML-ответ==

{| class="wikitable" width="75%"
|-
|TikList||Корневой элемент документа
|-
|colspan=2|'''Общая информация'''
|-
|TikList->Code||Код ТН ВЭД
|-
|TikList->Count||Количество записей для данного кода
|-
|colspan=2|'''Записи для кода'''
|-
|TikList->Notes||Список из записей
|-
|TikList->Notes->Note||Запись для кода
|}

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

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

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tik/xml/?srchstr=test

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd

Строка поиска не должна бытьслишком короткая: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0

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

@@ Строка 7: / Строка 7: @@
 ==API==
-Доступ к API предоставляется по URL https://www.alta.ru/tik/xml/.  Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля, либо доступ может быть предоставлен по статичному IP-адресу.
+Доступ к API предоставляется по URL https://www.alta.ru/tik/xml/.  Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.
 '''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
@@ Строка 13: / Строка 13: @@
 Вычисляем секрет: secret = md5("зерно:testlogin:md5(testpassword)")<br>
 Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f
 Ниже приводится полный список входных параметров:
@@ Строка 84: / Строка 82: @@
 |-
 |110||Лимит запросов для данного пользователя исчерпан
 |-
 |200||Строка поиска должна состоять из 3-х или более символов

@@ Строка 11: / Строка 11: @@
 '''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
 Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin<br>
-Вычисляем секрет: secret = md5("зерно:testlogin:testpassword")<br>
+Вычисляем секрет: secret = md5("зерно:testlogin:md5(testpassword)")<br>
 Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f

@@ Строка 97: / Строка 97: @@
 Лимит запросов для данного пользователя исчерпан:<br>
-https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd
+https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=ce3642297fe33bcb943829acf4cda884
 Строка поиска не должна быть слишком короткая:<br>
-https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0
+https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=ff5e9bec5d9f81665eb7920bee3a6a2f
 По данному запросу информация не найдена:<br>
-https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=46953aacb43eff6fcdbb408220a0152c
+https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=1415376d0aae6e94875c43e1d8e79b7e

@@ Строка 12: / Строка 12: @@
 Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin<br>
 Вычисляем секрет: secret = md5("зерно:testlogin:testpassword")<br>
-Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03
+Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f
 '''Для авторизации по статическому IP-адресу''' никакой дополнительной информации, кроме запроса, передавать не нужно. Запрос будет выглядеть как https://www.alta.ru/tik/xml/?srchstr=зерно
@@ Строка 46: / Строка 46: @@
 ==Примеры запросов==
 Подбор кодов по словосочетанию:<br>
-https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03
+https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f
 Дополнительные записи по словосочетанию и коду 1104291700:<br>
-https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03
+https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f

@@ Строка 99: / Строка 99: @@
 https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd
-Строка поиска не должна бытьслишком короткая:<br>
+Строка поиска не должна быть слишком короткая:<br>
 https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0

← Предыдущая	Версия 16:07, 25 марта 2022
(нет различий)

← Предыдущая	Версия 14:37, 25 марта 2022
(нет различий)