Быстрый старт

От пустого терминала до первой страницы товаров за несколько минут. Нужны панель магазина с правом управлять API и тариф, в который API входит.

Загружаем поисковый индекс…

Быстрый старт

Получите токен

  1. В панели магазина откройте «Настройки → API и вебхуки» и создайте приложение. Назовите его по своей системе, например ERP sync.
  2. Выберите нужные приложению scopes, например catalog:read и inventory:write, и не больше: см. приложения, токены и scopes.
  3. Выпустите токен приложения. Он показывается один раз: скопируйте его в хранилище секретов своей системы.

Примеры берут токен из переменной окружения SALEYA_API_TOKEN. Каждый запрос шлёт его в заголовке Authorization: Bearer; токен в адресе отклоняется.

Проверьте токен

GET /me работает с любым токеном и говорит, от чьего он имени: приложение, его scopes и точки, его лимиты запросов.

Запрос
curl "https://api.saleya.app/v1/me" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ответ
HTTP/1.1 200 OK

{
  "app": {
    "id": 12,
    "name": "ERP sync",
    "description": null,
    "scopes": [
      "catalog:read",
      "catalog:write",
      "inventory:read",
      "inventory:write",
      "orders:read"
    ],
    "allowed_ips": [
      "203.0.113.10"
    ],
    "all_locations": true,
    "location_ids": [],
    "created_at": "2026-11-02T09:15:00Z"
  },
  "token": {
    "name": "Production",
    "prefix": "saleya_at_3kQ9",
    "expires_at": null
  },
  "store_id": 7,
  "rate_limits": {
    "app": {
      "per_minute": 300,
      "burst": 100
    },
    "store": {
      "per_minute": 1200,
      "burst": 400
    }
  }
}

401 здесь значит, что токен не принят: проверьте, что он скопирован целиком. type ответа говорит, что именно не так, — см. ошибки.

Прочитайте настройки магазина

GET /store возвращает то, с чем читаются остальные ответы:

  • деньги — целое число в минорных единицах currency: 129900 в ARS — это 1 299,00; поля с окончанием _micro, например себестоимость, — в миллионных долях минорной единицы;
  • моменты — в UTC, RFC 3339: 2026-11-11T14:30:00Z; дни и часы работы магазина — в его timezone;
  • названия и описания — объекты по языкам, {"es": "…", "en": "…"}, на языках из supported_locales.
Запрос
curl "https://api.saleya.app/v1/store" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ответ
HTTP/1.1 200 OK

{
  "id": 7,
  "name": {
    "es": "Almacén Norte",
    "en": "North Grocery"
  },
  "currency": "ARS",
  "timezone": "America/Argentina/Buenos_Aires",
  "country": "AR",
  "default_locale": "es",
  "supported_locales": [
    "es",
    "en"
  ],
  "marketing_consent_mode": "opt_in"
}

Прочитайте товары

Список возвращает страницу записей в data и курсор следующей страницы. Запросите первую страницу товаров:

Запрос
curl "https://api.saleya.app/v1/products?limit=50" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"

Чтобы держать копию каталога, прочитайте список до конца и сохраните курсор синхронизации последней страницы: цикл показан в гайде страницы и синхронизация.

Что дальше

Следующий гайдПриложения, токены и scopes