# budu (буду) API

> REST API for selling and checking event tickets. The organizer's site sells a ticket and sends the order to budu over the API; budu issues tickets with QR codes, emails them to the guests and checks them at the door. Base URL: https://api.budu.events/v1. Auth: `Authorization: Bearer bt_test_…` (test mode) or `bt_live_…` (live).

The docs are written in Russian and translated into English: the same pages, the same anchors. Error messages in API responses are in Russian; branch on `error.code`, not on the text. The doc pages below are Markdown; the OpenAPI spec is YAML.

## Документация (русский, основной язык)

- [Быстрый старт](https://budu.events/docs/index.md): От тестового ключа до билета с QR за пять минут. Всё в тестовом режиме: настоящие продажи и гости этих запросов не увидят.
- [Ключи и запросы](https://budu.events/docs/auth/index.md): Как передать ключ, чем тестовый ключ отличается от боевого и в каком виде API принимает и отдаёт данные.
- [Тестовый режим](https://budu.events/docs/test-mode/index.md): Тестовый ключ работает с отдельными событиями и билетами, а письма отправляет только вам. Так интеграцию можно проверить до запуска продаж.
- [Идемпотентность](https://budu.events/docs/idempotency/index.md): Как повторить запрос после таймаута или обрыва связи и не продать один билет дважды.
- [Ошибки и лимиты](https://budu.events/docs/errors/index.md): Формат ошибки, все коды с HTTP-статусами, лимиты запросов и размеров и какие запросы стоит повторять.
- [События](https://budu.events/docs/events/index.md): Событие — это дата, площадка и тарифы. Создайте его черновиком, опубликуйте, и продажа откроется.
- [Места в зале](https://budu.events/docs/seats/index.md): Билеты на конкретные места: тариф с местами, схема зала файлом CSV и заказ места по его подписи или вашему идентификатору.
- [Заказы](https://budu.events/docs/orders/index.md): Заказ выпускает билеты. Отправьте его одним запросом после оплаты или придержите билеты резервом на время оплаты.
- [Билеты](https://budu.events/docs/tickets/index.md): Ссылки на билет для гостя, поиск, отмена, перевыпуск QR, повторное письмо и выгрузка билетов события в CSV.
- [Выдача без оплаты](https://budu.events/docs/issue/index.md): Билеты для гостей, партнёров и прессы: по одному запросом или списком гостей в CSV до 2 000 строк.
- [Контролёры на входе](https://budu.events/docs/devices/index.md): Подключите телефон контролёра по QR-приглашению, переименуйте или отзовите его и получите отчёт о проходах.

## Docs (English)

- [Quickstart](https://budu.events/en/docs/index.md): From a test key to a QR ticket in five minutes. Everything runs in test mode, so real sales and guests never see these requests.
- [Keys and requests](https://budu.events/en/docs/auth/index.md): How to pass the key, how a test key differs from a live one, and the shape of the data the API takes and returns.
- [Test mode](https://budu.events/en/docs/test-mode/index.md): A test key works with its own events and tickets and emails only you. That lets you check the integration before sales start.
- [Idempotency](https://budu.events/en/docs/idempotency/index.md): How to retry a request after a timeout or a dropped connection without selling one ticket twice.
- [Errors and limits](https://budu.events/en/docs/errors/index.md): The error format, every code with its HTTP status, request and size limits, and which requests to retry.
- [Events](https://budu.events/en/docs/events/index.md): An event is a date, a venue and tiers. Create it as a draft, publish it, and sales open.
- [Assigned seating](https://budu.events/en/docs/seats/index.md): Tickets for specific seats: a tier with seats, the seat map as a CSV file, and ordering a seat by its label or your own ID.
- [Orders](https://budu.events/en/docs/orders/index.md): An order issues tickets. Send it in one request after payment, or hold the tickets with a reservation while the buyer pays.
- [Tickets](https://budu.events/en/docs/tickets/index.md): Ticket links for the guest, search, cancel, QR reissue, email resend and a CSV export of an event's tickets.
- [Issue without payment](https://budu.events/en/docs/issue/index.md): Tickets for guests, partners and press: one at a time by request, or as a CSV guest list of up to 2,000 lines.
- [Door staff](https://budu.events/en/docs/devices/index.md): Pair a door staff phone with a QR invite, rename or revoke it, and get the check-in report.

## Optional

- [OpenAPI 3.1](https://budu.events/openapi.yaml): every API-key endpoint with its request and response schemas
- [Вся документация одним файлом](https://budu.events/llms-full.txt): the Russian docs in one Markdown file
- [The whole docs in one file](https://budu.events/en/llms-full.txt): the English docs in one Markdown file