IMAP Broker API - Public Changelog v1.3.0

Este changelog descreve apenas mudanças visíveis para consumidores da API.

1.3.0 - 2026-02-24

• Novos endpoints message/list-1.1 e message/search-1.1: Versões enriquecidas dos endpoints de listagem e busca. O campo data passa a ser um objeto com três campos: messages (lista de mensagens), result_count (quantidade retornada nesta resposta) e total_matched (total de mensagens que satisfizeram os critérios antes do limite ser aplicado). Use total_matched > result_count para detectar que há mais mensagens e paginar via from_uid.
• UID validity em listagem de mensagens: Os endpoints message/list-1.0 e message/list-1.1 passam a retornar o valor de uid_validity para a pasta listada. Em list-1.0, o campo é retornado em cada item da lista; em list-1.1, é retornado em data.uid_validity e também em cada item de data.messages.
• message/list-1.0 e message/search-1.0 marcados como deprecated: Os endpoints anteriores continuam funcionando sem qualquer alteração. Novas integrações devem utilizar as versões 1.1. Os endpoints 1.0 serão removidos em uma versão futura.
• Limite máximo de 1.000 mensagens: Os parâmetros max_messages (list) e limit (search) agora possuem um teto obrigatório de 1.000, aplicado nos endpoints 1.0 e 1.1. Requisições com valor superior retornam HTTP 406.
• Paginação por UID range agora respeita max_messages: Ao informar from_uid (com ou sem to_uid), o limite definido em max_messages passa a ser aplicado antes do FETCH, protegendo a conexão IMAP em pastas com grande volume de mensagens.
• Sem breaking changes — integrações com os endpoints 1.0 não requerem nenhuma alteração.

1.2.3 - 2026-02-14

• Novo Endpoint POST /message/search-1.0: Busca avançada com suporte a múltiplos critérios (Subject, Body, Dates, Flags, Tamanho).
• Suporte a Keywords (Tags/Labels personalizadas) no novo endpoint de busca (ex: etiquetas do Thunderbird ou Outlook).
• Correção de encoding em message/list-1.0: Nomes e Assuntos com caracteres especiais agora são retornados corretamente em UTF-8, eliminando problemas de "mojibake".

1.2.2 - 2026-02-12

• Padronização dos campos de data nos endpoints de mensagens.
• Campo internal_date passa a ser o campo principal e sempre vem preenchido.
• Campo rfc_date passa a existir somente em envelope e apenas quando o header Date estiver presente.
• Removido o campo date solto dos payloads para simplificar o contrato da API.

1.2.1 - 2026-02-11

• Listagem de mensagens agora retorna timezone consistente nas datas.
• Novos campos de data na listagem: INTERNALDATE e RFC Date normalizados.
• Campo principal de data prioriza RFC Date quando disponivel.

1.1.0 - 2026-02-10

• Maior estabilidade sob alta carga em operações IMAP.
• Melhorias de compatibilidade com assuntos e nomes em diferentes idiomas.
• Consistência entre lista e detalhes: assuntos agora aparecem corretos em ambos.
• Documentação de erros ampliada (respostas HTTP e mensagens padronizadas).
• Sem breaking changes para integracoes existentes.

1.0.0 - 2026-01-15

• Lançamento inicial da API IMAP Broker.
• Operações principais de mailbox, mensagens e anexos.

Voltar para a documentação