Ключи и запросы

Ключ API #

Каждый запрос несёт ключ организации в заголовке:

Authorization: Bearer bt_live_…

Ключи создаёт и отзывает владелец организации в кабинете, раздел интеграция → ключи API. Ключ работает в том режиме, в котором был открыт кабинет при его создании. Полный ключ показывают один раз. Мы храним только хэш, поэтому потерянный ключ не восстановить: отзовите его и создайте новый.

• Отозванный ключ перестаёт работать в течение 5 секунд.
• Ключ приостановленной организации не работает.
• Без ключа, с неверным или отозванным ключом ответ будет 401 unauthorized.

Адрес #

Базовый адрес API: https://api.budu.events/v1. Запросы принимаются только по HTTPS.

Организация и режим #

Организацию и режим определяет ключ. Поля org_id и livemode в теле запроса ни на что не влияют. Чужое событие, заказ или билет, а также объект другого режима выглядят как несуществующие: 404 not_found.

Что можно по ключу #

Ключи API, брендинг, тестовые адресаты, журнал действий и живые цифры события доступны только в кабинете. Ключ на такие запросы получает 403 forbidden с details.reason: "session_only".

Формат данных #

• Тело запроса — JSON в UTF-8, до 1 МБ. Файлы (места, список гостей, обложка) идут телом запроса как есть, со своим Content-Type.
• Имена полей в snake_case. Неизвестное поле в теле запроса даёт 400 invalid_request: опечатка в имени поля не пройдёт молча. Исключение — устройства (POST /v1/devices/invites, PATCH /v1/devices/{id}): там лишние поля игнорируются.
• Ответ содержит все поля объекта, даже пустые: строка "", число 0, список [], вложенный объект null.
• Идентификаторы — UUID строкой: "0193e0b2-4a7c-7d10-9e3f-2c5a8b1d4e60".
• Время — строка RFC 3339. В ответах всегда UTC: "2026-12-12T16:00:00Z". В запросах можно указать смещение: "2026-12-12T19:00:00+03:00".
• Поля *_ms — миллисекунды Unix. "0" значит «не было»: "checked_in_at_ms": "0" у билета, который не проходил.
• 64-битные числа (price_minor и все *_ms) в ответах приходят строкой: "price_minor": "250000". Так protobuf записывает их в JSON. В запросах подойдёт и число, и строка.
• Деньги — в минимальных единицах валюты: 250000 копеек — это 2 500 ₽. Валюта — трёхбуквенный код, по умолчанию RUB.

Заголовки #