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
outcomede 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.