API для партнёров

1Методы

Все ответы - только по вашему ассортименту и с вашими ценами: ключ определяет партнёра. Чужие объекты не видны - ответ 404.

2Синхронизация

Первый раз заберите все страницы /products. Дальше передавайте updated_since - время прошлой синхронизации, и придёт только изменённое:

• /products и /stock - товары и цвета, у которых менялись данные или остаток;
• /prices - товары, у которых менялись ступени цен, акции или ваши персональные цены; если ÖRNE включил новый прайс-лист - все позиции;
• когда меняется ваш уровень партнёрства (об этом придёт письмо), заберите /prices целиком.

curl "https://api.orne.kz/v1/stock?updated_since=2026-10-07T12:00:00%2B05:00&per_page=100" \
  -H "Authorization: Bearer orn_ваш_ключ"

В ответе списков есть meta: номер страницы, размер и общее количество - по нему видно, сколько страниц забирать.

3Пример ответа

GET /api/v1/products/ORN-0026 - пример, цены розничные; у партнёра - по его уровню

{
  "data": {
    "sku": "ORN-0026",
    "name": "Худи Oversize 340 г/м²",
    "category": "Одежда / Худи и свитшоты",
    "brand": null,
    "availability": "in_stock",
    "stock": 340,
    "min_qty": 10,
    "negotiable_from": 200,
    "tiers": [
      { "min": 10,  "max": 30,   "price": 17200 },
      { "min": 31,  "max": 99,   "price": 14620 },
      { "min": 100, "max": null, "price": 12900 }
    ],
    "print_methods": ["dtf", "emb", "silk"],
    "variants": [
      { "sku": "ORN-0026-01", "color_name": "Чёрный", "color_hex": "#231F20", "stock": 340, "images": [...] }
    ],
    "images": ["https://orne.kz/storage/..."],
    "canonical_url": "https://orne.kz/product/hudi-oversize-340-gm2",
    "updated_at": "2026-10-07T12:00:00+05:00"
  }
}

4Как считаются цены

Цена ступени - за штуку без нанесения, на нижней границе ступени. Её считает тот же расчёт, что цены на сайте, в вашем кабинете и КП: ваш уровень, скидка по категории, персональные цены и акции, минимальная цена товара. Нанесение зависит от метода, размера и тиража - его стоимость покажут корзина и КП.

Товары с ценой «по запросу» приходят с пустым списком tiers - цену уточнит менеджер.

5Ошибки и лимиты

Ошибка всегда в одном формате:

{
  "error": {
    "code": "validation_failed",
    "message": "Проверьте поля запроса",
    "fields": { "per_page": "Не больше 100 на страницу" }
  }
}

Каждый запрос записывается в журнал - его видно в кабинете, раздел «API-ключи»: время, метод, ответ и время ответа. Если что-то не сходится, по журналу быстро найдём причину.

6Вебхуки

Вместо частого опроса подпишите свой адрес на события в кабинете, раздел «Вебхуки». Доступно уровням Silver и Gold.

Событие приходит POST-запросом с телом {id, event, occurred_at, data} и заголовками X-ORNE-Signature, X-ORNE-Event, X-ORNE-Delivery. Ответьте кодом 2xx - иначе повторим через 1, 5, 30 и 120 минут. Приходят события только по вашим заказам и товарам вашего ассортимента. Проверка подписи:

// PHP: подпись - HMAC-SHA256 тела секретом подписки, hex
$body = file_get_contents('php://input');
if (!hash_equals(hash_hmac('sha256', $body, $secret), $_SERVER['HTTP_X_ORNE_SIGNATURE'] ?? '')) {
    http_response_code(401); exit;
}
$event = json_decode($body, true);   // $event['id'] - для защиты от повторной обработки
http_response_code(200);

7Выгрузки файлом

Если вашей системе проще забирать файл: в кабинете, раздел «Выгрузки», создайте постоянную ссылку на каталог с вашими ценами и остатками - CSV для Excel и 1С, XML или JSON. Файл обновляется каждые 15 минут, раз в час или раз в сутки. Партнёры уровня Gold выбирают колонки и их порядок. Ссылка работает без ключа - не публикуйте её; при утечке нажмите «Новая ссылка».

https://api.orne.kz/v1/feeds/ваш_токен.csv