Línguas
Todas as línguas em que uma mensagem pode ser enviada. Sem parâmetros, sem cursor, sem âmbito.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
GET /languages
Todas as línguas em que uma mensagem pode ser enviada. Sem parâmetros, sem cursor, sem âmbito.
Listá-las
Duzentas linhas, inteiras, numa só resposta. Obtenha-a uma vez e guarde-a. Um cliente que fixe a lista no código ou a raspe do documento OpenAPI fica desatualizado no dia em que for acrescentada uma linha.
curl "$OE/languages" -H "$AUTH"{ "object": "list", "data": [ { "code": "en", "label": "English", "native": "English", "flag": "🇬🇧", "rtl": false }, { "code": "de", "label": "German", "native": "Deutsch", "flag": "🇩🇪", "rtl": false }, { "code": "ar", "label": "Arabic", "native": "العربية", "flag": "🇸🇦", "rtl": true }, { "code": "ja", "label": "Japanese", "native": "日本語", "flag": "🇯🇵", "rtl": false } ]}Atrás de uma chave como tudo o resto e sem exigir qualquer âmbito: não nomeia dados pertencentes a ninguém, e um âmbito a guardar uma constante só torna o ecrã de consentimento mais longo.
rtl é sempre um boolean aqui. Dezasseis linhas são true (árabe, hebraico, persa, urdu e as restantes), e um corpo traduzido para uma delas é composto da direita para a esquerda.
Uma língua
Resposta
codestring- O código BCP-47, e a forma a guardar. `translate.to` aceita também as outras duas e responde sempre com esta.
labelstring- O nome em inglês: "Brazilian Portuguese". A segunda linha esbatida num seletor.
nativestring- Como a língua se designa a si própria: "Português (Brasil)". Mostre isto PRIMEIRO: é a palavra que alguém à procura da sua própria língua procura de facto.
flagstring- Dois codepoints de indicador regional. Um auxílio de leitura ao lado do nome nativo e nunca um identificador ou um rótulo por si só. Uma bandeira é um país, um país não é uma língua, e o espanhol não é a Espanha tal como o inglês não pertence a Inglaterra.
rtlboolean- Se a língua se escreve da direita para a esquerda. Está sempre presente, ao passo que a tabela subjacente a omite quando é false.
A ordem é a resposta
As linhas chegam pela ordem do seletor e não devem ser reordenadas por omissão: primeiro as línguas em que é mais provável que alguém receba correio, depois as variantes regionais, depois as restantes por região. Por ordem alfabética do nome em inglês, um seletor abre no abecásio.
Pesquise sobre native, label e code em conjunto, e apresente a lista tal como chega até alguém escrever. translate.to aceita qualquer uma das três, por isso um seletor que guarda code e pesquisa as três não consegue produzir um valor que o envio venha a recusar.