Документація api

API BooomTickets дозволяє інтегрувати сканування та управління квитками у ваші застосунки.

🎤 Події

1. Створити подію

Зареєструйте нову подію (концерт, фестиваль тощо)

POST /api/create-event
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "name": "Summer Fest 2025",
    "location": "Main Arena",
    "date": "2025-07-15T19:00:00Z"
}
        

2. Список подій

Отримати всі створені події

GET /api/events
Authorization: Bearer YOUR_API_TOKEN
        

[
    {
        "id": 12,
        "name": "Summer Fest 2025",
        "location": "Main Arena",
        "date": "2025-07-15T19:00:00Z"
    },
    {
        "id": 13,
        "name": "Rock Night",
        "location": "Stage B",
        "date": "2025-08-01T20:00:00Z"
    }
]
        

🎟 Квитки

1. Додати квиток

Додати квиток до події

POST /api/add-ticket
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "barcode": "ABC123XYZ",
    "event_id": 12,
    "holder_name": "Иван Иванов"
}
        

2. Перевірити квиток

POST /api/verify-ticket
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "event_id": 12,
    "barcode": "1234567890"
}
        

3. Статус квитка

GET /api/ticket-status/{barcode}
Authorization: Bearer YOUR_API_TOKEN
        

4. Список квитків

Отримати всі квитки для події зі статусами

GET /api/event/{event_id}/tickets
Authorization: Bearer YOUR_API_TOKEN
        

[
    {
        "barcode": "ABC123XYZ",
        "holder_name": "Иван Иванов",
        "status": "valid"
    },
    {
        "barcode": "XYZ987ABC",
        "holder_name": "Петр Петров",
        "status": "used"
    }
]
        

5. Журнал відміток

documentation.checkin_log_desc

POST /api/checkin-log
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "barcode": "1234567890",
    "device_id": "scanner01",
    "timestamp": "2025-05-28T19:00:00Z"
}