Для участия в нашей системе поиска электронных компонентов по складам поставщиков, Вы должны подготовить скрипт, который будет работать на Вашем сервере и производить вывод результатов по Вашей базе данных в нижеописанной спецификации.
Обязательные параметры, которые наш поисковый механизм будет отправлять по адресу расположения Вашего скрипта:
query - Строка поиска, переданная нашему серверу от пользователей. После проверки на недопустимые символы передается Вашему скрипту. login - Во избежании обращения к Вашим складам посредников и мошенников, Вы должны выделить нам имя пользователя и пароль. В случае неверного пароля или отсутствии последнего информация по запросу выдаваться не должна. password - Пароль.
Пример того, как мы обращаемся к складам:
http://yoursite.ru/search/kazus_find.php?query=max232&login=kazusru&password=kaz5123user Метод: GET Кодировка*: Windows-1251 (Кириллица)
* - если Ваш сервер передает данные в кодировке отличной от Windows-1251, сообщите нам об этом - мы встроим функцию преобразования кодировки на нашей стороне.
Если для корректной работы Вашего скрипта требуется передавать дополнительные параметры, укажите названия, значения и мы будем передавать их вместе со стандартной строкой запроса.
При выводе результатов скриптом на Вашей стороне должен использоваться формат XML. Формат вы видите ниже:
<data>
<item>
<part>НАЗВАНИЕ КОМПОНЕНТА</part>
<description>КРАТКОЕ ОПИСАНИЕ КОМПОНЕНТА</description>
<datasheet>ССЫЛКА НА ДОКУМЕНТАЦИЮ НА КОМПОНЕНТ</datasheet>
<image_path>ССЫЛКА НА ГРАФ. ИЗОБРАЖЕНИЕ КОМПОНЕНТА</image_path>
<manufacture>НАЗВАНИЕ ПРОИЗВОДИТЕЛЯ КОМПОНЕНТА</manufacture>
<package>КОРПУСНОЕ ИСПОЛНЕНИЕ КОМПОНЕНТА</package>
<valuta>ВАЛЮТА ПРИМЕНЯЕМАЯ К ЦЕНЕ КОМПОНЕНТА</valuta>
<roznica>РОЗНИЧНАЯ ЦЕНА</roznica>
<mopt>МАЛООПТОВАЯ ЦЕНА</mopt>
<opt>ОПТОВАЯ ЦЕНА</opt>
<sklad>НАЛИЧИЕ НА СКЛАДЕ, СРОК ДОСТАВКИ</sklad>
<buy_link>ССЫЛКА НА ЗАКАЗ КОМПОНЕНТА</buy_link>
</item>
<item>
<part></part>
<description></description>
<datasheet></datasheet>
.....
.....
.....
<buy_link></buy_link>
</item>
</data>
<data></data> - Теги определяющие структуру документа. Должны выводиться всегда, т.е. даже если по запросу на Вашем складе ничего не найдено, скрипт на Вашей стороне должен вывести:
<data></data>
Все, что находится вне этих тегов будет проигнорировано нашей системой.
<item></item> - Каждая найденая позиция на Вашем складе для отображения в нашей системе должна быть заключена в эти теги. Количество позиций при выводе Вашим скриптом ограничено 20. В случае, если будет выведено большее число позиций, наша ситема покажет пользователю первые 20. Данная структура включает в себя следующие теги:
<part></part> - Между этими тегами размещается наименование компонента.
Пример: <part>MAX232CPE</part>
Обязательный параметр.
<description></description> - Между этими тегами размещается краткое описание компонента.
Пример: <description>Микросхемы - интерфейсы RS-232</description>
Необязательный параметр.
<datasheet></datasheet> - Между этим тегами возможно размещение ссылки на описание компонента (страница html, php либо файл pdf).
Пример: <datasheet>http://yoursite.ru/path/to/docs/max232.pdf</datasheet>
Необязательный параметр.
<image_path></image_path> - Между этими тегами приветствуется размещение ссылки на графическое изображение компонента (рисунок в формате gif, jpeg, png).
Пример: <image_path>http://yoursite.ru/path/to/images/max232.gif</image_path>
Необязательный параметр.
<manufacture></manufacture> - Между этим тегами возможно указание производителя компонента.
Пример: <manufacture>Maxim Integrated Products Inc.</manufacture>
Необязательный параметр.
<package></package> - Указание типа исполнения корпуса компонента.
Пример: <package>PDIP16</package>
Необязательный параметр.
<valuta></valuta> - Указание типа валюты. Выражается кодом:
1 - Российские рубли 2 - Доллары USA 3 - Euro 4 - Гривны 5 - Другое
Пример: <valuta>2</valuta>
Обязательный параметр.
<roznica></roznica> - Розничная цена компонента. Цена при покупке 1шт. Цена указывается цифровым выражением, без указания валюты.
Пример: <roznica>45</roznica>
<mopt></mopt> - Малооптовая цена компонента. Цена указывается цифровым выражением, без указания валюты.
Пример: <mopt>43</mopt>
<opt></opt> - Оптовая цена компонента. Цена указывается цифровым выражением, без указания валюты.
Пример: <opt>40</opt>
! Обязательно указание хотя бы одной цены.
<sklad></sklad> - Указание наличия на складе и возможных сроков для заказа.
Примеры:
<sklad>527</sklad>
<sklad>Есть/Нет</sklad>
<sklad>Под заказ 2-3 недели</sklad>
Обязательный параметр.
<buy_link></buy_link> - Ссылка для перехода на сайт продавца для покупки компонента. Возможна ссылка позволяющаяч пользователю сразу поместить данный компонент в корзину интернет-магазина продавца.
Пример:
<buy_link>http://yoursite.ru/path/to/shop/korzina.php?part=245</buy_link>
Необязательный параметр.
Примечание: Необязательные параметры можно либо не указывать вообще, либо выдавать пустые теги:
Пример: Если у какой либо позиции нету данных о типе корпуса компонента можно пропустить вывод тегов <package></package>, либо вывести его пустым, т.е. <package></package> В случае, если у какой либо позиции отсутствует любой из обязательных параметров, данная позиция не будет показана пользователю на нашей стороне.
Если у Вас возникнут вопросы по подключению, пишите по адресу: admin@kazus.ru |