Llengües
Totes les llengües en què es pot enviar un missatge. Sense paràmetres, sense cursor, sense àmbit.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
GET /languages
Totes les llengües en què es pot enviar un missatge. Sense paràmetres, sense cursor, sense àmbit.
Llista-les
Dues-centes files, senceres, en una sola resposta. Demaneu-la un cop i conserveu-la. Un client que codifiqui la llista a mà o l'extregui del document OpenAPI queda desactualitzat el dia que s'hi afegeix una fila.
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 } ]}Darrere d'una clau com tota la resta i sense necessitat de cap scope: no anomena cap dada que pertanyi a ningú, i un scope que protegeix una constant només fa més llarga la pantalla de consentiment.
rtl aquí sempre és un boolean. Setze files són true (àrab, hebreu, persa, urdú i la resta), i un cos traduït a qualsevol d'aquestes es compon de dreta a esquerra.
Una llengua
Resposta
codestring- El codi BCP-47, i la forma que cal emmagatzemar. `translate.to` també accepta les altres dues i sempre respon amb aquesta.
labelstring- El nom en anglès: «Brazilian Portuguese». La segona línia atenuada d'un selector.
nativestring- Com s'anomena la llengua a si mateixa: «Português (Brasil)». Mostra-ho PRIMER: és la paraula que busca realment algú que cerca la seva pròpia llengua.
flagstring- Dos codepoints d'indicador regional. Una ajuda per localitzar-la al costat del nom natiu, i mai un identificador ni una etiqueta per si sola. Una bandera és un país, un país no és una llengua, i el castellà no és Espanya, igual que l'anglès no pertany a Anglaterra.
rtlboolean- Si la llengua s'escriu de dreta a esquerra. Sempre present, mentre que la taula subjacent l'omet quan és false.
L'ordre és la resposta
Les files arriben en ordre de selector i no s'haurien de tornar a ordenar per defecte: primer les llengües en què és més probable que algú rebi correu, després les variants regionals, i després la resta per regió. L'ordre alfabètic pel nom en anglès obre el selector amb l'abkhaz.
Cerca alhora sobre native, label i code, i renderitza la llista tal com arriba fins que algú escrigui. translate.to accepta qualsevol dels tres, de manera que un selector que emmagatzema code i cerca els tres no pot produir cap valor que l'enviament rebutgi.