Talen
Elke taal waarin een bericht kan worden verstuurd. Geen parameters, geen cursor, geen scope.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
GET /languages
Elke taal waarin een bericht kan worden verstuurd. Geen parameters, geen cursor, geen scope.
Ze opsommen
Tweehonderd rijen, compleet, in één respons. Haal het één keer op en bewaar het. Een client die de lijst hardcodeert of uit het OpenAPI-document schraapt is verouderd op de dag dat er een rij bij komt.
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 } ]}Achter een sleutel zoals al het andere en zonder scope: het noemt geen gegevens die iemand toebehoren, en een scope die een constante bewaakt maakt het toestemmingsscherm alleen maar langer.
rtl is hier altijd een boolean. Zestien rijen staan op true (Arabisch, Hebreeuws, Perzisch, Urdu en de rest), en een body die naar een van die talen is vertaald wordt van rechts naar links opgemaakt.
Een taal
Respons
codestring- De BCP-47-code, en de vorm om op te slaan. `translate.to` accepteert de andere twee ook en antwoordt altijd met deze.
labelstring- De Engelse naam: "Brazilian Portuguese". De gedempte tweede regel in een keuzelijst.
nativestring- Hoe de taal zichzelf noemt: "Português (Brasil)". Toon dit EERST: het is het woord waar iemand die zijn eigen taal zoekt daadwerkelijk naar zoekt.
flagstring- Twee regional-indicator-codepoints. Een hulpmiddel om te scannen naast de eigen naam en nooit een identificatie of een label op zichzelf. Een vlag is een land, een land is geen taal, en Spaans is net zomin Spanje als dat Engels van Engeland is.
rtlboolean- Of de taal van rechts naar links wordt geschreven. Altijd aanwezig, terwijl de onderliggende tabel het weglaat wanneer het false is.
De volgorde is het antwoord
De rijen komen binnen in keuzelijstvolgorde en horen standaard niet opnieuw gesorteerd te worden: eerst de talen waarin mensen het waarschijnlijkst gemaild worden, dan regionale varianten, dan de rest per regio. Alfabetisch op Engelse naam opent een keuzelijst op Abchazisch.
Zoek over native, label en code tegelijk, en render de lijst zoals hij binnenkomt totdat iemand typt. translate.to accepteert alle drie, dus een keuzelijst die code opslaat en alle drie doorzoekt kan geen waarde opleveren die de verzending weigert.