Lotes controlam disponibilidade e preço dos ingressos. Quando um lote esgota, o próximo na sequence_order é ativado automaticamente.
/v1/batchesCria um lote vinculado a um tipo de ingresso. O primeiro lote criado é ativado automaticamente.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ticket_type_id | uuid | OBRIGATÓRIO | ID do tipo de ingresso |
| name | string | OBRIGATÓRIO | Nome do lote |
| price | integer | Opcional | Preço em centavos (null = preço do tipo) |
| total_quantity | integer | OBRIGATÓRIO | Quantidade |
| sequence_order | integer | OBRIGATÓRIO | Ordem de ativação (1, 2, 3...) |
{
"ticket_type_id": "tt_uuid",
"name": "1º Lote",
"price": 4000,
"total_quantity": 200,
"sequence_order": 1
}{
"data": {
"id": "batch_uuid",
"name": "1º Lote",
"status": "active",
"price": 4000,
"sold": 0,
"total_quantity": 200
}
}/v1/batches/:id/activateAtiva um lote fora da sequência automática. Útil para promoções flash.
curl -X POST .../batches/batch_uuid/activate \ -H "Authorization: Bearer TOKEN"
{ "data": { "id": "batch_uuid", "status": "active" } }/v1/batches?ticket_type_id=...Lista todos os lotes de um tipo de ingresso.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ticket_type_id | uuid | OBRIGATÓRIO | ID do tipo |
curl .../batches?ticket_type_id=tt_uuid -H "Authorization: Bearer TOKEN"
{
"data": [
{ "id": "...", "name": "1º Lote", "status": "sold_out", "price": 4000 },
{ "id": "...", "name": "2º Lote", "status": "active", "price": 6000 }
]
}/v1/batches/:idRemove um lote. Só é possível se não houver vendas.
curl -X DELETE .../batches/batch_uuid -H "Authorization: Bearer TOKEN"
{ "message": "Batch deleted" }Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.
Uptime Garantido