API — Gestão de vouchers

Crie, liste, consulte e invalide vouchers programaticamente via API REST.

Autenticação

Header obrigatório: Authorization: Bearer SEU_TOKEN

Endpoints de Vouchers

Listar vouchers

GET /api/v1/vouchers
  ?location_id=loc_xxx
  ?status=active  (active | expired | exhausted)
  ?page=1&per_page=100

Criar vouchers

POST /api/v1/vouchers
Content-Type: application/json

{
  "location_id": "loc_xxx",
  "quantity": 10,
  "duration_hours": 24,
  "max_uses": 1,
  "prefix": "EVT"
}

Resposta:

{
  "created": 10,
  "vouchers": [
    { "id": "v_001", "code": "EVT-A4B2", "status": "active" },
    ...
  ]
}

Consultar voucher

GET /api/v1/vouchers/:code

Invalidar voucher

DELETE /api/v1/vouchers/:code

Invalida imediatamente o voucher, independentemente de usos restantes.