ВойтиРегистрация

Корпоративный API

Версионированный REST API для ERP-синхронизации. Авторизация Authorization: Bearer gcn_live_… или gcn_test_…. Ключи создаются в Business-кабинете.

Впервые? Начните с чеклиста онбординга партнёров.

Базовый URL

/api/v1

Машиночитаемый OpenAPI: /api/v1/openapi

Коллекция Postman: Скачать / импорт

Основные эндпоинты

  • GET /me — org + scopes
  • GET|POST /listings, /listings/bulk
  • GET|POST /inventory, /inventory/bulk (syncMode: upsert|replace)
  • /freight, /freight/bulk · /depots, /depots/bulk · /storage, /storage/bulk · /manufacturers, /manufacturers/bulk · /ports, /ports/bulk
  • /inquiries, /inquiries/{id}/reply
  • /organization, /webhooks, /bulk/{jobId}

Scopes

Новые ключи получают все scopes. Тонкое ограничение через модель данных.

  • listings:read
  • listings:write
  • inventory:read
  • inventory:write
  • freight:read
  • freight:write
  • depots:read
  • depots:write
  • storage:read
  • storage:write
  • manufacturers:read
  • manufacturers:write
  • ports:read
  • ports:write
  • inquiries:read
  • inquiries:write
  • org:read
  • org:write
  • webhooks:manage
  • bulk:write

Быстрый старт для партнёров

Пошаговые curl-примеры для sync каталога (все модули), запросов и webhooks:

docs/api-partner-guide.md

Проверка готовности: /api/v1/ready

Замечания

  • Неверифицированные org: создания остаются PENDING до одобрения админом.
  • Верифицированные org: API-создания/обновления публикуются как ACTIVE.
  • Используйте externalId + Idempotency-Key для безопасных ERP-retry.
  • Bulk макс. 200 позиций/запрос; webhooks до 3 повторов с backoff.
  • Webhooks подписаны HMAC (x-gcn-signature, x-gcn-timestamp).

Проверка…