Referência

Códigos de Erro

Referência completa de todos os códigos de erro retornados pela API OmniTicketz.

Formato de Resposta de Erro

401Exemplo de erro

{
  "success": false,
  "error": {
    "code": "PERMISSION_DENIED",
    "message": "API Key inválida ou sem permissão"
  }
}

Erros relacionados à autenticação e permissões.

Parâmetro	Tipo	Padrão	Descrição
`MISSING_API_KEY`	401	—	Header X-API-Key não foi enviado
`INVALID_API_KEY`	401	—	API Key inválida, desativada ou expirada
`PERMISSION_DENIED`	401	—	API Key não tem permissão para este endpoint

Erros de validação nos dados enviados.

Parâmetro	Tipo	Padrão	Descrição
`INVALID_VOUCHER_IDS`	400	—	Array de voucher_ids inválido ou vazio
`TOO_MANY_VOUCHERS`	400	—	Máximo de 100 vouchers por requisição
`MISSING_IDENTIFIER`	400	—	qr_code ou voucher_id é obrigatório
`ORDER_NOT_PAID`	400	—	Pedido não está pago (não pode fazer check-in)

Parâmetro	Tipo	Padrão	Descrição
`TENANT_MISMATCH`	403	—	QR Code não pertence a este tenant
`ticket_cancelled`	403	—	Ingresso cancelado ou bloqueado

Parâmetro	Tipo	Padrão	Descrição
`VOUCHER_NOT_FOUND`	404	—	Voucher não existe ou pertence a outro tenant
`VOUCHERS_NOT_FOUND`	404	—	Nenhum voucher encontrado com os IDs
`ticket_not_found`	404	—	Ingresso não encontrado pelo QR Code

Parâmetro	Tipo	Padrão	Descrição
`METHOD_NOT_ALLOWED`	405	—	Método HTTP incorreto (ex: POST em endpoint GET)

Parâmetro	Tipo	Padrão	Descrição
`ticket_already_used`	409	—	Ingresso já foi utilizado (check-in já realizado)

Parâmetro	Tipo	Padrão	Descrição
`ticket_expired`	410	—	Ingresso era válido para data passada

Parâmetro	Tipo	Padrão	Descrição
`ticket_not_valid_yet`	422	—	Ingresso válido para data futura
`ESTORNO_NAO_PERMITIDO`	422	—	Estorno só é permitido no mesmo dia do check-in
`SEM_CHECKIN`	422	—	Ingresso não possui check-in para estornar

Parâmetro	Tipo	Padrão	Descrição
`DATABASE_ERROR`	500	—	Erro ao acessar banco de dados
`INTERNAL_ERROR`	500	—	Erro inesperado no servidor