Developer Portal

Compatibilidade e migração

Breaking changes

Consulte as regras de compatibilidade e as alterações de contrato que podem afetar sua integração.

Compatibilidade v1.5.1

A versão v1.5.1 compartilha as rotas não-QR com o contrato v1.5.0 e adiciona compatibilidade dedicada para check-in por QR code.

  • O QR code check-in de v1.5.1 retorna um único objeto checkin.
  • Erros de QR code usam o shape simples { "message": ... } para assinatura inválida e QR code expirado.
  • Filtros de data legados aceitam yyyy-MM-dd, yyyy-MM-dd HH:mm:ss e ISO date-time.
  • Endpoints de pedidos aceitam status=true para incluir status não aprovados conforme o contrato legado.
  • ticketNumber de eventos DIY pode ser enviado sem hífen quando possuir 10 dígitos.

Versão 1.6.0 (2026-06-15) — contrato de participantes

Houve redução dos campos de ordenação e filtros aceitos nos endpoints de listagem de participantes:

  • Campos de ordenação aceitos reduzidos para ticket_created_at e ticket_updated_at; valores email, ticket_number, check_in_date e id retornam 400.
  • O parâmetro ticket_number foi removido dos endpoints de participantes por evento e por apresentação.
  • Os parâmetros from e to foram removidos do endpoint de participantes por pedido.
  • Cursors gerados com campos de ordenação removidos são invalidados; descarte cursors armazenados e reinicie a paginação.

Compatibilidade geral da versão 1.6.0

  • Os identificadores de participantes retornados pela API mudaram de formato em relação ao legado.
  • Endpoints de listagem que usavam paginação por página/offset agora utilizam paginação por cursor.
  • Listagens de participantes aceitam ordenação por ticket_updated_at.
  • Respostas de participantes incluem o campo ticket_net_value.