Справочник API

1. Можно ли верить данным: status

Релиз, свежесть источников и слепые зоны. Вызывайте первым.

curl -s https://radar.vibecommerce.ru/v1/status \
  -H "Authorization: Bearer $RADAR_API_KEY"

2. Найти ключ категории WB: find

Возвращает кандидатов с subject_id — он нужен для rates.

curl -s https://radar.vibecommerce.ru/v1/find \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"wb","kind":"category","query":"наушники беспроводные"}'

{ "candidates": [ { "key": { "subject_id": 593 }, "label": "Наушники беспроводные",
      "context": "Смартфоны и гаджеты", "match": "exact", "score": 1.0, "same_label": 1 } ],
  "total": 1, "truncated": false, "ambiguous": false, "groups": [] }

3. Найти кластер Ozon: find (kind=cluster)

Ключ приходит как {"cluster": …}; в rates он идёт под cluster_from и/или cluster_to — следующий пример.

curl -s https://radar.vibecommerce.ru/v1/find \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"ozon","kind":"cluster","query":"москва"}'

{ "candidates": [ { "key": { "cluster": "Москва, МО и Дальние регионы" },
    "label": "Москва, МО и Дальние регионы", "match": "partial",
    "directions": ["from", "to"], "same_label": 1 } ],
  "ambiguous": false }

4. Комиссия WB по предмету: rates

Ставки по моделям продаж FBW, FBS, DBS, C&C, бронирование, eDBS — с источником и датой. Здесь два элемента из шести. effective_from: null — WB дату вступления не публикует, сервис её не выдумывает.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"wb","key":{"subject_id":593}}'

{ "commission": { "unit": "pct", "source": "wb/tariffs/commission.json", "effective_from": null,
    "rates": [ { "model": "paidStorageKgvp", "model_label": "FBW (склад WB)", "value": 30.5 },
               { "model": "kgvpMarketplace", "model_label": "FBS (маркетплейс)", "value": 35.0 } ] } }

5. Логистика WB по складу и объёму: rates

С liters приходит итог. available: false — тарифа на это сочетание нет; это не ноль.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"wb","key":{"warehouse":"Склад WB РФ"},"liters":3}'

{ "logistics": [ { "what": "logistics", "model": "paidStorageKgvp", "first_liter": 78.2, "extra_liter": 23.8,
      "unit": "rub", "liters": 3, "value": 125.8, "source": "wb/tariffs/box.json" },
    { "what": "logistics", "model": "kgvpMarketplace", "available": false } ] }

6. Комиссия Ozon для цены: rates

price выбирает ценовой сегмент (без него отдаются все), model оставляет одну модель: "model":"FBO". Про рост ставки с ценой — абзац «Ценовые сегменты Ozon» выше.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"ozon","key":{"category_path":["Электроника","Наушники и гарнитуры","Наушники"]},"price":1500}'

{ "as_of": "2026-10-15", "price_plan": "base",
  "commission": { "unit": "pct", "effective_from": "2026-10-07",
    "rates": [ { "model": "FBO", "segment": "свыше 300 ₽", "value": 47.0 },
               { "model": "FBS", "segment": "свыше 300 ₽", "value": 47.0 } ] } }

7. Логистика Ozon по маршруту: rates с кластерами

cluster_from — откуда отгрузка, cluster_to — куда доставка, liters — объём единицы. next_edition есть, когда Ozon уже объявил следующую редакцию логистики: здесь с 30.10 ставка «свыше 300 ₽» вырастет со 100 до 130 ₽.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"ozon","key":{"category_path":["Электроника","Наушники и гарнитуры","Наушники"],
       "cluster_from":"Москва, МО и Дальние регионы","cluster_to":"Санкт-Петербург и СЗО"},"liters":2}'

{ "logistics": { "default_tariff": false, "unit": "rub", "effective_from": "2026-08-28",
    "rates": [ { "price_segment": "до 300 ₽", "liters": 2.0, "value": 32.0 },
               { "price_segment": "свыше 300 ₽", "liters": 2.0, "value": 100.0 } ],
    "next_edition": { "effective_from": "2026-10-30",
      "changed": [ { "price_segment": "свыше 300 ₽", "value": 130.0, "now": 100.0 } ] } } }

8. Хранение Ozon: срок без платы и плата после него

part: "storage" вместо комиссии и логистики. Для приёмки FBO — "acceptance". valid_until — последний день действия редакции.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"ozon","key":{"category_path":["Электроника","Наушники и гарнитуры","Наушники"]},"part":"storage"}'

{ "part": "storage",
  "free_days": { "unit": "days", "effective_from": "2026-10-01", "valid_until": "2026-12-31",
    "rates": [ { "goods": "regular", "value": 344.0 }, { "goods": "kgt", "value": 39.0 } ] },
  "after_free_period": { "unit": "rub_per_liter_day",
    "rates": [ { "goods": "regular", "value": 2.5 }, { "goods": "kgt", "value": 0.08 } ] } }

9. Приёмка WB: отказ not_available

WB отключила метод приёмки для всех продавцов — данных нет. HTTP 422; повторять бесполезно, пока WB его не вернёт. Для WB part не применяется, кроме этого отказа.

curl -s -w '\nHTTP %{http_code}\n' https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"wb","key":{"subject_id":593},"part":"acceptance"}'

{ "ok": false, "op": "rates", "data": null,
  "error": { "code": "not_available",
    "message": "WB отключила этот метод для всех продавцов; данных нет и не будет, пока WB его не вернёт",
    "next_step": "повторять не нужно: слепая зона wb.acceptance в blind_spots; ставки склада WB
                  (логистика, хранение, возврат, палета) — rates(key={warehouse}) без part",
    "candidates": [] }, … }
HTTP 422

10. Что изменилось в офертах с 15 сентября: changes

Домены: tariffs, api, offers, law, news. Остальные страницы — по cursor. У оферт interpretation_status пока pending: номера пунктов читать по ссылке.

curl -s https://radar.vibecommerce.ru/v1/changes \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"offers","from":"2026-09-15"}'

11. Тарифные изменения Ozon за две недели: changes

Дата считается от сегодняшней. Событие — id, observed_at, effective_from, kind, significance, title, url (поля — в разделе changes).

FROM=$(date -u -v-14d +%F 2>/dev/null || date -u -d '14 days ago' +%F)
curl -s https://radar.vibecommerce.ru/v1/changes \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d "{\"from\":\"$FROM\",\"domain\":\"tariffs\",\"platform\":\"ozon\"}"

{ "total": 2, "happened": [ { "id": "fa7f79d5f762", "observed_at": "2026-10-07",
      "effective_from": "2026-10-07", "domain": "tariffs", "platform": "ozon",
      "kind": "edition_published", "significance": "high",
      "title": "вознаграждение Ozon (базовый прайс)", "url": "https://seller-edu.ozon.ru/…" }, … ] }

12. MCP напрямую, без клиента: tools/call и tools/list

Так проверяют подключение. Протокол — JSON-RPC, ответ приходит обычным JSON; заголовок Accept обязателен. Ответ инструмента — тот же конверт в result.structuredContent, отказ предметной области — с result.isError: true. Список инструментов — тот же запрос с "method":"tools/list" и без params: status, overview, find, rates, changes.

curl -s https://radar.vibecommerce.ru/mcp \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find","arguments":{"platform":"wb","kind":"category","query":"наушники беспроводные"}}}'

{ "jsonrpc": "2.0", "id": 1,
  "result": { "isError": false,
    "content": [ { "type": "text", "text": "{\"ok\": true, \"op\": \"find\", …}" } ],
    "structuredContent": { "ok": true, "op": "find", "data": { … }, "error": null, … } } }

13. MCP: список инструментов

Те же операции, что в REST, — с параметрами и описаниями для агента.

curl -s https://radar.vibecommerce.ru/mcp \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

14. Остаток лимита: заголовки X-RateLimit-*

Каждый ответ несёт сколько вызовов в минуту разрешено и сколько осталось. При превышении — 429 с Retry-After.

curl -s -D - -o /dev/null https://radar.vibecommerce.ru/v1/status \
  -H "Authorization: Bearer $RADAR_API_KEY"

HTTP/2 200
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 59

Машиночитаемая схема: GET /v1/schema

JSON Schema параметров всех операций, перечисления, формы ключей, лимиты и коды ошибок — одним ответом.

curl -s https://radar.vibecommerce.ru/v1/schema \
  -H "Authorization: Bearer $RADAR_API_KEY"

То же через GET: параметры в адресе

Любую операцию можно вызвать GET с параметрами в query-строке; для ключей rates удобнее POST с JSON.

curl -s -G https://radar.vibecommerce.ru/v1/find \
  -H "Authorization: Bearer $RADAR_API_KEY" \
  --data-urlencode "platform=wb" --data-urlencode "kind=category" \
  --data-urlencode "query=платье" --data-urlencode "limit=2"

Что будет, если передать строку вместо ключа

HTTP 422, error.code = "needs_key", в candidates — подходящие ключи. Ставку по строке Радар не отдаёт.

curl -s https://radar.vibecommerce.ru/v1/rates \
  -H "Authorization: Bearer $RADAR_API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"wb","key":"наушники"}'

Неизвестная операция: HTTP 404 с полным конвертом

Тело не JSON-объект даёт HTTP 400. Оба отказа — код invalid, полный конверт и next_step со списком операций; разбирать HTML не придётся.

curl -s -w '\nHTTP %{http_code}\n' https://radar.vibecommerce.ru/v1/nope \
  -H "Authorization: Bearer $RADAR_API_KEY"

{ "ok": false, "op": "nope", "data": null,
  "error": { "code": "invalid",
    "message": "нет операции 'nope'; есть: ['changes', 'find', 'overview', 'rates', 'status']",
    "next_step": "операции — status, overview, find, rates, changes; справочник — GET /v1",
    "candidates": [] }, … }
HTTP 404