Endpoints

Endpoint:
/Sectors

Gerencie setores (GENERAL_ADMISSION ou SEATED) e assentos numerados com reserva via Redis locks.

Última AtualizaçãoMAR 2026
POST/v1/events/:id/sectors

Criar setor

Cria um setor vinculado a um evento.

Parâmetros

CampoTipoObrigatórioDescrição
namestringOBRIGATÓRIONome do setor
typestringOBRIGATÓRIOGENERAL_ADMISSION ou SEATED
capacityintegerOBRIGATÓRIOCapacidade
{
  "name": "Pista VIP",
  "description": "Área exclusiva",
  "type": "GENERAL_ADMISSION",
  "capacity": 500
}
Resposta
201 Created
{ "data": { "id": "sector_uuid", "name": "Pista VIP", "capacity": 500 } }
POST/v1/sectors/:id/seats/bulk

Criar assentos em massa

Cria múltiplos assentos de uma vez para setores do tipo SEATED.

Parâmetros

CampoTipoObrigatórioDescrição
seatsarrayOBRIGATÓRIOArray de { row, number }
{
  "seats": [
    { "row": "A", "number": "1" },
    { "row": "A", "number": "2" },
    { "row": "B", "number": "1" }
  ]
}
Resposta
201 Created
{ "data": { "created": 3, "sector_id": "sector_uuid" } }
POST/v1/seats/:id/reserve

Reservar assento

Reserva um assento específico. Expira em 15 min. Redis locks previnem double-booking.

Parâmetros

CampoTipoObrigatórioDescrição
reservation_iduuidOBRIGATÓRIOID da reserva
{ "reservation_id": "res_uuid" }
Resposta
200 OK
{ "data": { "seat_id": "...", "status": "reserved" } }
GET/v1/sectors/:id/seats/available

Assentos disponíveis

Lista assentos disponíveis de um setor. Suporta filtro por fileira.

Parâmetros

CampoTipoObrigatórioDescrição
rowstringOpcionalFiltrar por fileira
curl .../sectors/sector_uuid/seats/available?row=A
Resposta
200 OK
{
  "data": [
    { "id": "...", "row": "A", "number": "1", "status": "AVAILABLE" },
    { "id": "...", "row": "A", "number": "3", "status": "AVAILABLE" }
  ]
}

Pronto para escalar?

Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.

99.9%

Uptime Garantido

API
terminalAPI Sandbox
api.flair.api.br
Flair