OneCatalog API

Документация по публичным API OneCatalog для разработчиков. Здесь собраны два API:

API	Назначение	Объём в документации
Wiki API	Справочник товаров, брендов, категорий, коллекций, стран, единиц измерения, характеристик и видов товара.	Полностью — все методы.
B2B API	B2B-платформа поставщиков и ритейлеров.	Только публичный метод «Цены и остатки по ключу» (share-products/{url_key}). Остальные методы доступны авторизованным партнёрам и в документацию не входят.

Базовые адреса

API	Base URL
Wiki	https://api.onecatalog.net/wiki
B2B	https://api.onecatalog.net/b2b

Локализация ответов

Оба API поддерживают мультиязычные ответы через query-параметр lang. Доступные значения:

Код	Язык
ru	Русский (по умолчанию)
en	English
ar	العربية
zh	中文
kk	Қазақша

Пример:

curl "https://api.onecatalog.net/wiki/v1/products/?lang=en"

В ответах присутствует блок meta.i18n с фактически применённым языком и языком-фолбэком.

Авторизация

• Wiki API — большинство методов публичны. Для расширенных полей передавайте API-ключ в query-параметре api-key или заголовке X-API-Key.
• B2B API (публичный share-products) — доступ по url_key прайс-листа; при необходимости дополнительный private_key передаётся query-параметром.

Формат ответа

Ответы возвращаются в JSON. Многие методы Wiki поддерживают параметр response_fmt (json, yaml, yml, xml) и выгрузку файлом (is_download=1). Пагинация — через start и limit.

подсказка

Слева в разделах Wiki API и B2B API — полный список методов с описанием параметров, схемами ответов и примерами запросов. У каждого метода доступна кнопка отправки запроса прямо из документации.