Por que os formulários HTML e APIs ainda usam corpos codificados em urlencode x-www-form?
Muitos sistemas ainda querem postagens em formato de formulário, o estilo clássico de aplicação x formulário codificado em URL, e muitos problemas ainda começam com uma incompatibilidade entre um primeiro cliente JSON e um gateway de primeiro formulário. Para as equipes de operações e produtos, o problema é o erro que parece um problema de autenticação quando o problema real é uma linha de tipo de conteúdo, um conjunto de caracteres ou uma chave repetida de uma forma que o servidor não mapeia da maneira que você pensa. Um passe on-line de codificação de corpo de formulário é como você cria uma pequena reprodução, compara-a com uma amostra funcional e transforma um 415 ou 401 em um ticket baseado em fatos, em vez de um clima. Um construtor on-line gratuito com código de URL do formulário x www ajuda um profissional de marketing experiente em tecnologia, um líder de suporte e um proprietário de back-end a alinhar um pacote de reprodução, porque todos podem ver a mesma sequência de chaves, não uma história sobre a sequência. O custo emocional da incompatibilidade de formato é um dia perdido em uma ponte de conferência onde as pessoas têm boas intenções e ainda falam umas com as outras, porque a palavra JSON e a forma da palavra não descrevem os mesmos bytes. O benefício é um vocabulário compartilhado e um artefato arquivável, e esse é o caminho mais rápido para uma solução. Quando estiver pronto, defina o tipo de conteúdo e o conjunto de caracteres para corresponder a uma política, use UTF-8 a menos que uma especificação legada force uma chamada diferente e tenha cuidado com segredos, porque uma pasta de depuração pode se tornar um vazamento mais rápido do que uma reunião pode terminar. Uma verificação on-line pós-codificação de formulário é uma ponte curta entre as pilhas antigas e novas, e é mais importante quando a migração está pela metade, o que é um ano muito comum em uma empresa maior. A recompensa prática é menos ciclos com parceiros, um caminho mais curto para integração de fornecedores e um script de suporte que é mais fácil de entregar a um novo contratado, o que é uma gentileza para você no futuro.
Como trabalhar com x-www-form-urlencoded
- Nomeie seu cabeçalho Content-Type explicitamente e combine a codificação de texto não-ASCII com UTF-8, a menos que uma especificação herdada force algo diferente, com uma exceção escrita de propriedade de um engenheiro sênior, e não um boato.
- Digite vários valores da maneira que seu servidor espera (chave repetida ou chaves indexadas) e documente isso em sua API pública, não apenas em Slack privado.
- Onde existirem segredos, use HTTPS, tokens de curta duração e registre campos mínimos; nunca publique senhas em serviços de “depuração” de terceiros sem a aprovação da política.