Для участия в нашей системе поиска электронных компонентов по складам поставщиков, Вы должны подготовить скрипт, который будет работать на Вашем сервере и производить вывод результатов по Вашей базе данных в нижеописанной спецификации.

  Обязательные параметры, которые наш поисковый механизм будет отправлять по адресу расположения Вашего скрипта:

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>

Все, что находится вне этих тегов будет проигнорировано нашей системой.

<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