Получите токен
- В панели магазина откройте «Настройки → API и вебхуки» и создайте приложение. Назовите его по своей системе, например
ERP sync. - Выберите нужные приложению scopes, например
catalog:readиinventory:write, и не больше: см. приложения, токены и scopes. - Выпустите токен приложения. Он показывается один раз: скопируйте его в хранилище секретов своей системы.
Примеры берут токен из переменной окружения 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"Чтобы держать копию каталога, прочитайте список до конца и сохраните курсор синхронизации последней страницы: цикл показан в гайде страницы и синхронизация.
Что дальше
- Шлите
Idempotency-Keyс каждой записью, чтобы повтор не применил её дважды, — идемпотентность. - Правка записи с версией требует её
ETagвIf-Match— версии и If-Match. - Подпишитесь на события вместо опроса — вебхуки.
- Проверяйте на отдельном магазине своего аккаунта — магазин для разработки.