Уважаемые партнеры,

Мы благодарим Вас за стремление к сотрудничеству. Наша компания ценит своих партнеров и предлагает отличное качество текстильных изделий, богатый ассортимент продукции ведущих мировых брендов и максимально комфортные условия сотрудничества, которые несомненно увеличат материальную прибыль и возможности Вашего магазина. Мы хотим, чтобы Вы хорошо зарабатывали на продаже нашего товара. Поэтому в прайсе указана рекомендованная розничная стоимость с минимальной наценкой 60-70%. Мы приветствуем проведение согласованных акций и распродаж на часть ассортимента, сопряженных со специальными ценовыми предложениями. Нашими сотрудниками разработана удобная схема сотрудничества вашего интернет-магазина с компанией. Мы предлагаем универсальную систему API.

Что такое API? Зачем это нужно?

Application Programming Interface - интерфейс программирования или создания приложений. В данном случае API нужен для интеграции вашего магазина с нашей базой данных. Интерфейс позволяет в любой момент времени получить актуальные данные по ассортименту продукции на нашем складе.

В чем преимущества?

  • API прост и удобен в использовании;
  • предлагает несколько форматов получаемых данных (xml, json, csv, xlsx);
  • фиксирует изменения в базе продукции (количества или стоимости, скидки, наличие или отсутствие товара и пр.), благодаря чему вы всегда работаете с актуальными данными;
  • предполагает использование как в ручном, так и в автоматическом режимах;
  • не ограничен рамками интернет-магазинов;
  • позволяет получать данные по одному или нескольким необходимым параметрам;
  • разрешает указать свой коэффициент наценки;

Что нужно для работы с API? Как получить ключ?

Для начала Вам нужно получить API_KEY (индивидуальный ключ).
  1. Регистрация. Она необходима для получения индивидуального ключа для работы с интерфейсом. Чтобы получить доступ к API, Вам необходимо зарегистрироваться в панели управления. Для этого нажмите кнопку «Зарегистрироваться» либо перейдите по ссылке http://apiadm.textiloptom.net/register Далее заполните необходимые данные: Ваш e-mail, имя пользователя и т.д. Нажмите кнопку «Ок».
  2. Начало работы. После регистрации нажмите на надпись «Войти в панель управления». Вы увидите индивидуальный ключ «API_KEY», который состоит из 32 символов (буквы английского алфавита и цифры). В дальнейшем «API_ KEY» следует добавлять в конец необходимой ссылки или указанные строки. Сохраните ключ!
  3. Работа программиста. После получения ключа обратитесь к специалисту, который занимается программным обеспечением Вашего магазина. Можно воспользоваться услугами сторонних профессионалов. На сайте есть контактные данные программистов, имеющих положительный опыт работы с предлагаемым интерфейсом, а также непосредственно разработчиков API. Не забудьте сообщить программисту Ваш ключ к API.

Обязателен ли программист?

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

Сколько стоят услуги программиста?

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

Что делать, если возникли трудности?

Смотрите пункт "Обязателен ли программист" или обратитесь к разработчикам данного API.

Можно ли заменить другой программой?

Вы можете использовать файл с остатками, представленный на нашем сайте http://www.textiloptom.net/ost.php

Зачем нужен ключ?

Ключ необходим для индивидуализации процесса работы. На сегодняшний момент ведется работа по усовершенствованию интерфейса с целью расширения функционального назначения:
  • использование индивидуальной системы скидок;
  • возможность указания коэффициента наценки через панель управления самостоятельно;
  • выбор склада;
  • мастер создания интернет-магазина «в 1 клик» нашим партнерам.

У меня есть ключ. Что дальше?

Ключ необходимо сообщить программисту, осуществляющему программное обеспечение непосредственно Вашего интернет-магазина. Или же обратить внимание на контактные данные специалистов, которые являются отличными знатоками данного приложения. Можно обратиться и разработчикам API. Не забудьте сообщить программисту Ваш ключ к API.

Что делать, если я не помню ключ?

Если Вы забыли ключ, то нужно обратиться непосредственно к разработчикам предложенного интерфейса API. Контактные данные Вы найдете на нашем сайте.

Как часто происходит обновление данных?

Обновление данных в АПИ происходит моментально. Например, если на складе появился новый товар или изменилась стоимость продукции, то новые данные незамедлительно попадают в API. Но в базе данных Вашего магазина обновление не появится. Для этого нужно периодически выполнять синхронизацию, предпочтительно 1 раз в день.

Могу ли я получить только необходимые данные, а не все?

В API Вы можете получить как полные данные, так и только по одному или нескольким конкретным необходимым параметрам. Например, функция «products» («Товары»)* Представляет собой перечень продукции из всех категорий с ограниченным списком параметров (артикул, наименование, id-категории). Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».
Название функции Описание функции Ссылка функции
products Товары. Перечень товаров из всех категорий с ограниченным списком параметров:
  • артикул
  • наименование
  • id категории
http://api.textiloptom.net/v4/Api/products?api_key=ВАШ API_KEY
Шаг1. В таблице выбираем функцию «products» («Товары») и необходимую ссылку (в третьей колонке). Шаг2. Переходим по ссылке, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слова «products», свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/products?api_key=API_KEY Шаг3. В результате получаем список продукции в формате xml. * В личном кабинете есть таблица с полным списком возможных функций.

Сколько стоит это чудо?

Использование текущего интерфейса абсолютно бесплатно. Возможен вариант разработки разного рода интерфейсов, необходимых непосредственно для Вашего магазина. О стоимости интерфейса можно узнать у разработчика, написав письмо на почту admin@web-craft.pro с темой «разработка интерфейса».

Есть ли готовое решение для моей CMS?

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

Какую версию использовать?

Существуют несколько версий интерфейса. Рекомендуемая версия – последняя, так как она усовершенствована с учетом пожеланий наших партнеров.

Где посмотреть, как это работает?

http://www.handybrands.ru/ http://buonanotte.ru/

Могу ли я указать свои цены на товары?

Да. API позволяет указать коэффициент наценки в определенных рамках. То есть товар, который стоит 1000 можно продавать, например, за 800 или 1700.

Есть ли изображения товара?

Да, есть. Вы можете получить архивы больших или маленьких изображений.
Надеемся, что мы ответили на все необходимые вопросы. Оцените по достоинству все плюсы нашего API, воспользовавшись его возможностями. Несомненно, наше партнерство принесет положительные аспекты в развитие Вашего бизнеса. Мы рады сотрудничеству.


Ниже приведены пошаговые инструкции для наиболее распространенных в использовании функций. Каждая инструкция включает в себя 2 основных шага. Как видите, использование приложения API –простой и легкий способ получения необходимых данных о предлагаемой продукции. Основной принцип алгоритма работы с API – это указать в ссылке название желаемой функции и необходимого формата данных, а также индивидуальный ключ в конце. Напоминаем, что полный список функции отображен в таблице, которая есть в личном кабинете.

Функция «info».

Здесь представлена подробная информация, в том числе:
  • параметр - путь к каталогам с большими и маленькими изображениями товаров;
  • параметр - справочник параметров.
Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».

Шаг1. Переходим по ссылке http://api.textiloptom.net/v1/Api/info?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/info?api_key= ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем данные.

Функция «categories».

Эта функция предоставляет список товарных категорий. Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».

Шаг1. Переходим по ссылке http://api.textiloptom.net/v1/Api/categories?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/categories?api_key= ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем данные о категориях.
Чтобы получить данные в необходимом формате (xml, json, csv, xlsx) нужно дописать название формата в ссылке перед вопросительным знаком. http://api.textiloptom.net/v1/Api/categories.{название формата}?api_key=ВАШ API_KEY

Функция «category».

Здесь указан перечень товара только необходимой категории. К примеру категории «category/7». В списке будут указаны наименования с id=7 Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY». В ссылке, после слова «category/», вместо «0» нужно вписать номер необходимой категории.

Шаг1. Переходим по ссылке http://api.textiloptom.net/v1/Api/ category/0?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/categories?api_key=ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем ассортимент категории.
Чтобы получить данные в необходимом формате (xml, json, csv, xlsx) нужно дописать название формата в ссылке перед вопросительным знаком. http://api.textiloptom.net/v1/Api/category.{название формата}?api_key=ВАШ API_KEY

Функция «products».

В данной функции имеется информация о товарах из всех категорий с ограниченным списком параметров:
  • артикул
  • наименование
  • id-категории
Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».

Шаг1. Обратите внимание: в ссылке, после слова «category/», вместо «0» нужно вписать номер необходимой категории. Переходим по ссылке http://api.textiloptom.net/v1/Api/ products?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/ products?api_key= ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем наименование товаров с вышеуказанными параметрами.
Чтобы получить данные в необходимом формате (xml, json, csv, xlsx) нужно дописать название формата в ссылке перед вопросительным знаком. http://api.textiloptom.net/v1/Api/products{название формата}?api_key=ВАШ API_KEY

Функция «productsExt».

Основное отличие от функции «products» - это список продукции из всех категорий с полным перечнем параметров:
  • <id> - id товара
  • <name> -наименование;
  • <article> - артикул;
  • <par_cat_id> -id родительской категории;
  • <cat_id> -id категории;
  • <brand> - производитель
  • <color_count> - количество цветов
  • <pict_style> - стиль картинки
  • <textile> - ткань
  • <filler> - наполнитель
  • <duvet> - одеяло
  • <pillowcase> - наволочка
  • <sheet> - простыня
  • <param_value> - значение параметра, влияющего на цену
  • <param_name> - наименование параметра, влияющего на цену
  • <price> -цена;
  • <count_goods> -количество товара в наличии;
  • <img_name> - имя файла изображения товара.
Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».

Шаг1. Переходим по ссылке http://api.textiloptom.net/v1/Api/ productsExt?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/ productsExt?api_key= ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем наименование товаров с вышеуказанными параметрами.
Чтобы получить данные в необходимом формате (xml, json, csv, xlsx) нужно дописать название формата в ссылке перед вопросительным знаком. http://api.textiloptom.net/v1/Api/productsExt.{название формата}?api_key=ВАШ API_KEY

Функция «productsVal».

Это список продукции из всех категорий с полным перечнем параметров, но вместо id указаны значения параметров, то есть данные имеют расшифрованный вид Обратите внимание, что переходя по ссылке необходимо обязательно указывать необходимую версию API(v1, v2, v3, v4) и индивидуальный «API_ KEY».

Шаг1. Переходим по ссылке http://api.textiloptom.net/v1/Api/ productsVal?api_key=ВАШ API_KEY, обязательно указав необходимую версию API(v1, v2, v3, v4) и после слов «api key=» свой API_ KEY т.е в конце: http://api.textiloptom.net/{необходимая версия API}/Api/ productsVal?api_key= ВАШ API_KEY Ссылка отображается вверху в адресной строке.
Шаг2. В результате получаем данные.
Чтобы получить данные в необходимом формате (xml, json, csv, xlsx) нужно дописать название формата в ссылке перед вопросительным знаком. http://api.textiloptom.net/v1/Api/ productsVal.{название формата}?api_key=ВАШ API_KEY


Изменения

ниже публикуются последние изменения в API

11/04/2016

  • Добавлен параметр "Состав"

26/08/2014

  • В 4-й версии API исправлена выгрузка цен, до сегодняшнего дня некоторые цены выгружались с учетом скидок
    и отличались в меньшую сторону от рекомендуемой розничной на 5-20%

12/07/2014

  • Добавлен метод(oc_imp) выгрузки ассортимента в виде файла Microsoft Excel(*.xlsx).
    http://api.textiloptom.net/v4.xlsx/api/oc_imp/{cat_id}?api_key={your_api_key}
    Данные в книге представлены в следующем виде:
    • Первый лист - дерево категорий
    • Второй лист - перечень продуктов
    • Третий лист - дополнительные изображения продуктов (не используется)
    • Четвертый лист - перечень опций товара с выводом наценки на варианты (от минимальной цены)
    • Пятый лист - атрибуты товаров

12/07/2014

  • 4-я версия API

25/03/2014

  • Из методов, возвращающих товарные наименования исключен фильтр по количеству остатков. Раньше остаток был 0 при условии, что истинный остаток был не больше 3. Теперь это ограничение отсутствует.

05/03/2014

  • в ответ методов productsVal и productsExt добавлен параметр article_and_param_val, являющийся объединением полей артикул и название параметра, влияющего на цену товара

28/02/2014

  • в ответ методов productsVal и productsExt добавлен параметр article_and_param, являющийся объединением полей артикул и id параметра, влияющего на цену товара

23/02/2014

Третья версия АПИ*

  • исправлен недочет с изменением время от времени ID товаров, теперь ID будут постоянными**
* адреса методов изменились, соответственно если во второй версии было
api.textiloptom.net/v2/Api/productsVal?api_key=[API_KEY]
в третьей версии меняется номер версии - v3, и адрес метода будет
api.textiloptom.net/v3/Api/productsVal?api_key=[API_KEY]
** эти исправления доступны только в текущей версии АПИ, в прошлых ничего не поменялось, можете пользоваться и дальше,
если все устраивает (если при импорте на свой сайт эти ID вами не использовались)


Если ранее было

{
"id": "26922", - ! вот это число менялось
"name": "КПБ GG-14",
"article": "GG-14",
"par_cat_id": "Постельное белье",
"cat_id": "Гобелен сатин (арт. GG)",
"brand": "Вальтери",
"color_count": "Цветное",
"pict_style": null,
"textile": "Сатин",
"filler": null,
"duvet": "150х215",
"pillowcase": "2шт-50х70",
"sheet": "160х215",
"base_color": null,
"param_id": "282",
"param_value": "1.5 спальный",
"param_name": "размер постельного белья",
"price": "3368",
"count_goods": "0",
"img_name": "kpb-gg-14.jpg"
},


Сейчас

{
"id": "6863", - ! это число будет постоянно соответствовать только этому товарному наименованию
"name": "КПБ GG-14",
"article": "GG-14",
"par_cat_id": "Постельное белье",
"cat_id": "Гобелен сатин (арт. GG)",
"brand": "Вальтери",
"color_count": "Цветное",
"pict_style": null,
"textile": "Сатин",
"filler": null,
"duvet": "150х215",
"pillowcase": "2шт-50х70",
"sheet": "160х215",
"base_color": null,
"param_id": "282",
"param_value": "1.5 спальный",
"param_name": "размер постельного белья",
"price": "3368",
"count_goods": "0",
"img_name": "kpb-gg-14.jpg"
},


При интергации АПИ с вашим сайтом учитывайте, что у товаров с одинаковым артикулом, но разными размерами - одинаковые ID.
Это сделанно для того, чтобы на вашем сайте возможно было отображать одно изображение товара с одним артикулом и всеми доступными вариантами размеров.


09/01/2013

  • Исправлен вывод дополнительных характеристик постельного белья (наволочки, пододеяльники, простыни)


10/12/2013

  • Появилась "песочница", в которой можно посмотреть список методов и потестировать каждый там же.


07/12/2013

Во второй версии API:

  • В методах productsVal, productsExt исправлена ошибка, приводившая к выводу разного количества записей в этих методах
  • В методах productsVal, productsExt добавлена сортировка по id
  • В методах productsVal, productsExt добавлен вывод параметра base_color - основной цвет для комплектов постельного белья
  • В методe info теперь возвращаются только пути к изображениям
  • Параметры выводятся в новом методе params
Вышеуказанные изменения не затрагивают первую версию, в ней все по-старому, пользуйтесь новой)


29/11/2013

  • В полноразмерных фото убран watermark


28/11/2013

Доступна вторая версия API. В ней реализован весь функционал первой версии с небольшими изменениями:

  • В метод category теперь можно передавать id необходимых категорий через запятую
  • Метод category теперь можно вызывать совсем без параметра категории, будет возвращен перечень всех товарных наименований
  • В методах productsVal, productsExt, productsExtK добавлен необязательный параметр cat_id (http://api.textiloptom.net/v2/Api/productsVal/14?api_key=***)
  • Добавлен JsFormat, немного отличающийся от имеющегося json (вызов через суффикс .js http://api.textiloptom.net/v2/Api/productsVal.js?api_key=***)
  • Исправлены найденные баги
Для вызова методов второй версии необходимо в URL заменить порядковый номер версии:
версия 1 - http://api.textiloptom.net/v1/Api/category/2?api_key=***
версия 2 - http://api.textiloptom.net/v2/Api/category/2?api_key=***


20/11/2013

  • Добавлен метод productsExtK, позволяющий указывать наценку к базовой цене (коэффициент наценки не может быть больше 1,7 )