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

Первый успешный запрос к API примерно за пять минут. Здесь используется api-key — для него не нужен OAuth, потому что вы обращаетесь к собственному аккаунту.

1. Создайте интеграцию

В левом меню панели Bito откройте Интеграция → Интеграция и нажмите Кастомная интеграция. В окне Создание интеграции нажмите + Создать в строке Внешняя интеграция.

Укажите название, остальное пока оставьте пустым и нажмите Сохранить. Подробный разбор полей — в разделе Создание интеграции.

2. Скопируйте три значения

При сохранении Bito покажет client_id, secret и api_key. secret виден только здесь, один раз — скопируйте все три значения в надёжное место, прежде чем закрыть окно, см. Ключи доступа.

Для быстрого старта нужен только api_key. Он выглядит так: mycompany:9ad41c0e7b3f28d5610ac94e7f1b26d8.

3. Установите интеграцию

Интеграция создаётся, но не устанавливается. Пока она не установлена, каждый запрос к API возвращает ошибку Integration is not installed.

На странице Интеграция в списке Установлены откройте новую интеграцию и нажмите Установить. Установка также запускает redirect_uri и webhook_uri, если они указаны — см. Хуки установки и удаления.

4. Сделайте запрос

Запросы списков идут через POST — их фильтры передаются телом. Чтение одной записи — GET, изменение — PUT, удаление — DELETE.

curl -X POST \
  'https://api.bito.uz/integration-api/integration/api/v2/product/get-paging' \
  -H 'api-key: mycompany:9ad41c0e7b3f28d5610ac94e7f1b26d8' \
  -H 'Content-Type: application/json' \
  -H 'Accept-Language: ru' \
  -d '{ "page": 1, "limit": 5 }'

Ответ

{
    "code": 0,
    "message": "Success",
    "status_code": 200,
    "data": {
        "total": 1043,
        "data": [
            { "_id": "6712f0a9c4d1e87b3a0f9911", "name": "Эспрессо" }
        ]
    },
    "time": "2025-05-01T12:00:00Z"
}

code: 0 означает успех. Записи лежат в data.data, их общее количество — в data.total.

TIP

Получили 401? Заголовок называется api-key, а не Authorization, и значение включает часть до двоеточия. Получили 404? Проверьте базовый URL — он заканчивается на /integration/api/v2/.

5. Выберите дальнейший путь

Что вы делаете	Читайте дальше
Решение только для своего аккаунта	Работа с API, затем справочник API — либо виджет для своего аккаунта, если нужен экран внутри Bito
API-интеграцию для маркетплейса	Получите статус разработчика, затем OAuth 2.0: обзор
Публичный виджет внутри Bito	Страница приложения, затем Пользовательские виджеты
Реакцию на изменения данных	Вебхуки данных

Когда всё работает — отправьте интеграцию на проверку. У публичного виджета карточка и релиз проверяются отдельно; одобрение делает приложение доступным для установки, а не устанавливает его автоматически.