Ваш браузер устарел, страница может отображаться с ошибками, рекомендуем установить Google Chrome
Чтобы воспользоваться всеми функциями, зарегистрируйтесь или войдите в систему
Система Youvend – автоматизирует взаимодействие между поставщиками товаров и их клиентами
В нашей базе более 706 поставщиков и 49601 товар

API

Чтобы автоматизировать импорт цен и остатков в систему было разработано API. С помощью него можно поддерживать всегда актуальным состояние ваших товаров в системе. Чтобы получить доступ к API необходимо сгенерировать ключ в настройках профиля компании в разделе "API", полученный ключ необходимо добавлять к каждому запросу. Запросы к API осуществляются по протоколу HTTP методами GET и POST. API может отвечать в двух форматах: JSON и XML (по умолчанию JSON).

Методы

Красным отмечены обязательные входящие параметры
Метод Строка запроса Входящие данные Формат ответа Исходящие данные
Получение списка своих товаров /api/catalog?token={token} token - сгенерированный ключ
success:true,
 result: [
  id:{id},
  identifier:{identifier}
  title:{title},
  packing:{packing},
  amount:{amount},
  price:{price},
  currency:{currency},
  quantity:{quantity}
]
					

result - массив объектов

id - идентификатор Youvend

identifier - идентификатор компании

title - наименование товара

packing - упаковка

amount - вес/объем

price - стоимость

currency - валюта (eur/usd/eur)

quantity - кол-во (few/many/0..99999/'')

Обновление остатков и цен

/api/import?token={token}

POST:

 items: [
 id:{id},
 identifier:
  {identifier},
 price:{price},
 quantity:{quantity},
 currency:{currency}
]
					

token - сгенерированный ключ

items - массив объектов для записи

id - ID Youvend

identifier - идентификатор компании

(является обязательным наличие хотя бы одного из двух параметров)

price - цена

quantity - остаток ( ''/few/many/0..99999)

currency - валюта (rub/eur/usd)

success:true,
errors:{
 total:{
  total:
   {errors.total.total},
  noId:
   {errors.total.noId},
  duplicateById:
   {errors.total.duplicateById},
  duplicateByIdentifier:
   {errors.total.duplicateByIdentifier},
  notFound:
   {errors.total.notFound}
 },
 items:{
  noId:[],
  duplicateById:[],
  duplicateByIdentifier:[],
  notFound:[]
 }
}
					

errors - является false если импорт прошел без ошибок, в ином случае содержит поля total и items.

errors.total.total - общее кол-во ошибок

errors.total.noId - кол-во объектов, у которых не указан ни ID ни IDENTIFIER

errors.total.duplicateById - кол-во объектов которые были продублированы на входе по ID

errors.total.duplicateByIdentifier - кол-во объектов которые были продублированы на входе по IDENTIFIER

errors.total.notFound - кол-во объектов которые не были найдены ни по ID ни по IDENTIFIER

errors.items - содержит одноеменные массивы total, которые содержат в себе переданные объекты с соответствующими ошибками

Поиск товаров по каталогу /api/search?term={term}&skip={skip}&limit={limit}&token={token}

token - сгенерированный ключ

term - строка запроса поиска

limit - кол-во выдаваемых результатов (максимум - 100, по умолчанию - 100)

skip - кол-во пропусков результата, считается с начала (по умолчанию - 0)

success:true,
result: [
 id:{id},
 title:{title},
 packing_count:
  {packing_count},
 packing_title:
  {packing_title},
 amount:{amount},
 price:{price},
 identifier:{identifier}
]
					

result - массив объектов

id - идентификатор Youvend

title - наименование товара с упаковкой и объемом/весом

packing_count - кол-во в упаковке,

packing_title - тип упаковки

amount - вес/объем,

price - если указана цена компании

identifier - если указан идентификатор компании

Ошибки

Код ошибки Сообщение Описание
1000 Неизвестная ошибка -
1001 Неизвестный формат запрашиваемых данных

Запрошенный формат результата не поддерживается. Допустимые форматы: json и xml.

(к строке запроса добавляется &format=%format%)

1002

В запросе не указан token Строка запроса не содержит токен
1003 Указанный токен не зарегистрирован Переданный в строке запроса токен не обнаружен в системе
1004 Метод %method% не найден Запрошенный метод не найден
1005 В запросе %query% не найден обзятельный параметр %parameter% или он является пустым В переданных параметрах упущено обязательное значение или его содержание пустое
1006 Внутренняя ошибка системы В процессе выполнения запроса произошла внутреняя ошибка. Следует связаться с администратором.