Разработчикам

API для интеграций Saleya

Читайте и меняйте каталог, остатки, заказы и покупателей магазина из своей системы и получайте вебхуки, когда что-то меняется.

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

Первый запрос

  1. 1

    В панели магазина откройте «Настройки → API и вебхуки» и создайте приложение с нужными ему scopes — по шагам это показано в гайде «Быстрый старт».

  2. 2

    Выпустите токен приложения. Он показывается один раз — сохраните его рядом с остальными секретами своей системы. Как токены меняют и отзывают — в гайде «Приложения, токены и scopes».

  3. 3

    Вызовите GET /me с токеном: ответ покажет магазин и scopes токена.

Пример запроса
curl "https://api.saleya.app/v1/me" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
  • Ошибки

    Страница на каждый тип отказа: когда возникает, что делать и какое у ответа тело.

    Ошибки →
  • Журнал изменений

    Все изменения контракта API по датам, политика версий и лента Atom, чтобы за ними следить.

    Журнал изменений →

Гайды по API

Как API для интеграций Saleya ведёт себя за пределами одного метода: доступ, синхронизация, повторы, конфликты, лимиты и вебхуки.

Начало работы

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

    Получите токен в панели магазина и сделайте первые запросы: токен, магазин и первая страница товаров.

  • Приложения, токены и scopes

    Что может приложение, как его ограничивают scopes, как выпускать, менять и отзывать токены и как их хранить.

  • Магазин для разработки

    Проверяйте интеграцию в отдельном магазине своего аккаунта: тестовых токенов у API нет.

Работа с данными

  • Страницы и синхронизация

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

  • Массовые операции

    Устанавливайте остатки, записывайте товары и выгружайте заказы тысячами одним файлом NDJSON, а не запросом на запись.

  • Вебхуки

    Подпишите адрес на события магазина, проверьте подпись на PHP, Node.js или Python и обработайте повторы.

  • Бухгалтерия через API

    Загрузите учёт магазина в бухгалтерию или ERP и держите его актуальным: какой налог брать, деньги, удержания и закрытые периоды.

Надёжная интеграция

  • Ошибки

    Как выглядит отказ, что значит каждый статус и какие ошибки стоит повторять.

  • Идемпотентность

    Повторите запись после таймаута и не примените её дважды: заголовок Idempotency-Key.

  • Версии и If-Match

    Меняйте запись, не затирая то, что изменили в магазине после вашего чтения.

  • Лимиты запросов

    Сколько запросов могут слать приложение и магазин, как читать заголовки лимитов и что делать на 429.

  • Версии API

    Что может появиться в /v1 без предупреждения, что не меняется никогда и как объявляются устаревания и новые версии.

Гайды →