Pular para o conteúdo principal

Filtros e ordenação

Filtros​

A maioria dos endpoints de listagem aceita filtros específicos do recurso como query parameters. Filtros de intervalo usam sufixos entre colchetes:

GET /v1/emails?status=approved
                &created_at[gte]=2026-01-01T00:00:00Z
                &created_at[lt]=2026-02-01T00:00:00Z

Operadores suportados em campos de data e numéricos: gt, gte, lt, lte, mais in (lista separada por vírgula) em todo campo. Campos array como to casam linhas que contêm o valor (?to=x@y.com). Cada recurso aceita só os filtros listados na sua página em Recursos; filtro desconhecido, campo não ordenável ou valor malformado (id que não é UUID, timestamp inválido) é rejeitado com 400 validation_failed.

Ordenação​

GET /v1/emails?sort=-created_at

Prefixo - para ordem decrescente. Várias chaves podem ser separadas por vírgula (sort=from,-created_at); id é sempre o desempate final. O padrão é -created_at (mais recentes primeiro). Só os campos listados na página de cada recurso em Recursos podem ser ordenados — são colunas não nulas, para que a paginação keyset permaneça exata.