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

1Зарегистрируйтесь как разработчик

Перейдите на admin.bazex.co и создайте аккаунт. При регистрации выберите роль Разработчик. Это откроет доступ к порталу разработчика, где вы сможете создавать и управлять приложениями.

2Создайте первое приложение

Перейдите в раздел Мои приложения в портале разработчика и нажмите Создать приложение. Заполните основные данные:

• Название — отображаемое имя приложения
• Slug — URL-идентификатор (нельзя изменить после создания)
• Redirect URL — адрес, на который мерчант будет перенаправлен после OAuth-авторизации
• Scopes — к каким данным приложению нужен доступ

После создания вы получите Client ID и Client Secret. Сохраните секрет в надёжном месте — он показывается только один раз.

3Тестовая установка в песочнице

Каждому разработчику доступен sandbox-бизнес для тестирования. На странице приложения нажмите Тестовая установка. Это установит приложение в вашу песочницу и выдаст токен доступа (fbat_...) без прохождения OAuth.

4Сделайте первый API-запрос

Используйте токен доступа для вызова App API. Вот как получить список товаров:

curl -X GET https://api.bazex.co/app-api/products \
  -H "Authorization: Bearer fbat_your_access_token" \
  -H "Content-Type: application/json"

const res = await fetch('https://api.bazex.co/app-api/products', {
  headers: {
    'Authorization': 'Bearer fbat_your_access_token',
    'Content-Type': 'application/json',
  },
});

const { data, total, page, limit } = await res.json();
console.log(`Found ${total} products`);

Ответ содержит пагинированные данные товаров, привязанные к бизнесу мерчанта.

5Настройте вебхуки

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

curl -X POST https://api.bazex.co/webhooks \
  -H "Authorization: Bearer fbat_your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/bazex",
    "events": ["order.created", "product.updated"]
  }'

В ответе будет secret (формат: whsec_...) для проверки подписи вебхуков. Подробнее — в руководстве по вебхукам.

6Отправьте на проверку

Когда приложение готово, нажмите Отправить на проверку в портале разработчика. Команда Bazex проверит приложение и одобрит его или предоставит обратную связь. После одобрения приложение появится в публичном маркетплейсе.

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