← Todos os posts

FourA Digest: 12 a 19 de junho de 2026

Páginas não UTF-8 retornam texto legível no Single em vez de mojibake, regras de validação definem a classificação de sucesso, e o reforço de segurança Wave 0 foi lançado.

Destaques

Duas mudanças desta semana afetam o que retorna das suas requests. Os corpos das responses deixam de chegar como mojibake em sites que não usam UTF-8, e responses não-200 aceitas por validação finalmente contam como sucesso em vez de falha. Também fechamos algumas brechas de segurança na API do cliente.

O Que Há de Novo

Páginas que não usam UTF-8 retornam texto legível no Single

Se você chama o Single em fóruns búlgaros, e-commerce chinês, notícias japonesas ou qualquer site que envie windows-1251, GBK, Big5 ou Shift_JIS, o corpo da response costumava retornar como bytes corrompidos. A camada HTTP subjacente tinha um decodificador UTF-8 fixo no código, então uma página em cirílico chegava como промоции e não havia como recuperar o original do seu lado.

Isso foi corrigido na camada de request. Agora, o Single detecta o charset de origem (via header Content-Type, depois <meta charset>, depois <meta http-equiv>) e faz a transcodificação para UTF-8 antes que o corpo chegue ao seu envelope JSON. Páginas em UTF-8 ou ASCII passam sem alterações. Conteúdo binário como imagens ou PDFs nunca é decodificado. Se você quiser os bytes brutos, returnBuffer: true ainda entrega o buffer original.

Ativo por padrão. Nenhuma flag para alterar. Páginas que funcionavam antes continuam funcionando; páginas que retornavam lixo agora retornam texto legível. Usuários de navegador também não precisam se preocupar com isso; o Chromium decodifica charsets nativamente.

Regras validate agora orientam a classificação de sucesso

Quando você define validate em uma request (por exemplo, validate.status.accept = [200, 403]), o mecanismo de request já respeitava a sua regra e resolvia a response sem erro. Mas o nosso classificador de resultado upstream ignorava a sua regra e agrupava qualquer coisa que não fosse um 200 literal como application_fail. Duas consequências: o seu 403 aceito aparecia como falha no Dashboard e, como apenas o sucesso é faturável, essas responses entregues também não eram faturadas.

O classificador agora respeita o que foi declarado pelo validate. Requests com validate contam como sucesso sempre que o mecanismo as resolveu sem erro, qualquer que seja o status. Requests sem validate se comportam como antes (sucesso apenas no 200), mantendo o fluxo legado intacto.

Correção válida apenas daqui para frente: registros históricos mantêm o resultado armazenado, novas requests são classificadas corretamente. Portanto, se você vinha vendo App Fail em responses que sabia serem válidas, este é o motivo.

Reforço de segurança na API do cliente

Lançamos a Onda 0 de uma revisão de segurança em toda a API do cliente:

  • CORS agora está restrito a https://foura.ai. A configuração anterior refletia qualquer origem enquanto enviava credenciais, o que é o cenário padrão para CSRF. Chamadas de navegador com a mesma origem e as suas chamadas de API no lado do servidor não são afetadas.
  • A rota de métricas por trás da sua linha do tempo de Atividade aceitava um filtro outcome de formato livre que ia direto para a consulta. Agora ela usa uma lista de permissões com valores de resultado conhecidos. Não era explorável a partir de uma conta normal, mas valia a pena fechar.

Nenhum deles altera contratos de API. Você não vai notar nada durante o uso normal. Mas encontrar um problema e resolvê-lo antes que alguém perceba ainda merece ser compartilhado.

Rótulos de atividade agora correspondem à Visão Geral

Uma mudança pequena. A tabela de Atividade no seu Dashboard exibia strings de resultado brutas como Application_fail, enquanto os blocos, o gráfico de rosca e a linha do tempo da Visão Geral mostravam rótulos amigáveis (App Fail) e identificavam cada resultado por cor. Os mesmos dados, duas apresentações. Agora eles estão sincronizados, ambos consumindo o mesmo mapeamento de cores e rótulos, para que o status de uma linha seja idêntico em qualquer lugar onde você consultar.

Números

Esta semana não traz novos números de latência ou taxa de sucesso. A maior parte disso é trabalho de correção e segurança, em que a métrica certa é "parar de errar" em vez de "ser mais rápido". O resumo da próxima semana deve trazer dados de throughput de algumas melhorias em andamento.