A documentação da API em português ou em inglês: onde está cada língua e como mudar

WhatsApp e APIs·· 53 visualizações· 2 min de leitura

A resposta curta: toda a documentação existe em português e em inglês, página a página. O selector de língua no topo leva à mesma página na outra língua, sem voltar ao início.

Onde está cada língua

Uma das línguas fica na raiz do endereço e a outra numa pasta própria: /pt para o português ou /en para o inglês. Na raiz fica a língua principal da documentação da MozOut. Se abrir a pasta da língua que está na raiz, a documentação leva-o ao mesmo sítio, por isso as ligações com /pt ou /en funcionam sempre.

Atalhos: a documentação em português e a documentação em inglês.

Em algumas marcas, o selector mostra também os países do site; cada país leva à língua da documentação que lhe corresponde.

O que muda com a língua, e o que não muda

O quê Com a língua
Textos, títulos e menus Traduzidos.
Exemplos de código Iguais, com o cabeçalho Accept-Language na língua da página.
Nomes de campos, caminhos, permissões e códigos de erro Em inglês nas duas línguas.
Mensagens de erro da API Dependem do cabeçalho Accept-Language do pedido, não da língua da página. Sem o cabeçalho, vêm em inglês.
Pesquisa Cada língua tem o seu índice.
Versões Markdown Uma por página e por língua.
llms.txt Um só ficheiro, com as duas listas.

A língua das mensagens no seu programa

Para receber as mensagens de erro em português, o seu programa envia:

Accept-Language: pt

O campo code do erro nunca muda com a língua. É por ele que o programa decide; a mensagem serve para mostrar a pessoas.

O seu programador prefere inglês? Envie-lhe as ligações da versão inglesa, que tem o mesmo conteúdo. Veja como entregar a documentação a um programador.

Quer ler em inglês? A mesma documentação, página a página.

Ver a versão em inglês

VEJA TAMBÉM

A nossa documentação da API: o que é, para quem é e como lá chegar

Entregar a documentação da API a um programador: ligações a secções, Markdown e a especificação

Pesquisar na documentação da API: Ctrl+K, a tecla /, resultados por secção e pesquisas recentes

A documentação da API em Markdown: Ver em Markdown, Copiar página e para que servem

Como está organizada a documentação da API: Começar, Áreas, Referência e Playground

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5,94 €/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.