GGet Goods
← Продавцам

Для разработчиков

Seller Integration API

Подключите CMS, ERP или свой бэкенд к витрине Get Goods. Авторизация — отдельным ключом продавца, без cookie и браузерной сессии.

Интерактивный Swagger

Изучайте только server-to-server методы и проверяйте запросы через Try it out. Перед выполнением вставьте полный ключ ggsk_… в кнопку Authorize.

Открыть Swagger

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

  1. 1

    Создайте ключ

    Владелец витрины создаёт ключ с нужными scope в кабинете. Полный секрет показывается один раз.

  2. 2

    Загрузите фото или укажите CDN URL

    Отправьте файл в POST /media/primary и используйте возвращённый URL при upsert. Внешний HTTPS URL своего CDN также подходит.

  3. 3

    Выберите категорию через API

    Найдите действующую конечную категорию в GET /categories и передайте её category_id при upsert.

  4. 4

    Синхронизируйте карточку

    Выполните полный PUT /items/{external_sku} с новым Idempotency-Key и актуальным source_updated_at.

  5. 5

    Дождитесь обработки

    Если upsert вернул operation_id, запрашивайте его статус до succeeded или failed с ограниченной паузой.

Категория из канонического справочника

Запросите GET /categories?query=… с ключом catalog:write и используйте возвращённый category_id. API показывает только действующие конечные категории Get Goods; исходные категории Wildberries и Ozon не принимаются.

Спецификация OpenAPI

Отдельный контракт содержит только Seller Integration API — без браузерного кабинета, админки, внутренних маршрутов и credentials маркетплейсов.

OpenAPI JSONOpenAPI YAML

Authorization

curl --fail-with-body
  -H "Authorization: Bearer $SELLER_API_KEY"
  https://get-goods.ru/api/v1/seller-api/items

Не передавайте ключ в frontend, URL, публичный репозиторий или логи. Ключ всегда ограничен одной витриной и выбранными scope.