Aller à la documentation
API

Langues

Toutes les langues dans lesquelles un message peut être envoyé. Aucun paramètre, aucun cursor, aucune portée.

GETapi.openemail.uk/languages

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

GET /languages

Toutes les langues dans lesquelles un message peut être envoyé. Aucun paramètre, aucun cursor, aucune portée.

Les lister

Deux cents lignes, entières, en une seule réponse. Récupérez-la une fois et conservez-la. Un client qui code la liste en dur ou l'extrait du document OpenAPI devient obsolète le jour où une ligne est ajoutée.

curl
curl "$OE/languages" -H "$AUTH"
Réponse
{  "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 }  ]}

Derrière une clé comme tout le reste, et sans portée requise : elle ne nomme aucune donnée appartenant à quiconque, et une portée gardant une constante ne fait qu'allonger l'écran de consentement.

rtl est toujours un boolean ici. Seize lignes valent true (arabe, hébreu, persan, ourdou et les autres), et un corps traduit dans l'une d'elles est composé de droite à gauche.

Une langue

Réponse

codestring
Le code BCP-47, et la forme à stocker. `translate.to` accepte aussi les deux autres et répond toujours avec celle-ci.
labelstring
Le nom anglais : "Brazilian Portuguese". La seconde ligne atténuée dans un sélecteur.
nativestring
Le nom que la langue se donne : "Português (Brasil)". Affichez-le EN PREMIER : c'est le mot que cherche réellement quelqu'un qui cherche sa propre langue.
flagstring
Deux points de code indicateurs régionaux. Une aide au repérage à côté du nom natif, et jamais un identifiant ni une étiquette à lui seul. Un drapeau est un pays, un pays n'est pas une langue, et l'espagnol n'est pas l'Espagne pas plus que l'anglais n'appartient à l'Angleterre.
rtlboolean
Indique si la langue s'écrit de droite à gauche. Toujours présent, là où la table sous-jacente l'omet lorsque c'est false.

L'ordre est la réponse

Les lignes arrivent dans l'ordre du sélecteur et ne doivent pas être retriées par défaut : d'abord les langues dans lesquelles les gens ont le plus de chances de recevoir du courrier, puis les variantes régionales, puis le reste par région. Un tri alphabétique sur le nom anglais ouvre un sélecteur sur l'abkhaze.

Effectuez la recherche sur native, label et code à la fois, et affichez la liste telle qu'elle arrive jusqu'à ce que quelqu'un saisisse quelque chose. translate.to accepte l'une quelconque des trois formes : un sélecteur qui stocke code et cherche dans les trois ne peut donc pas produire une valeur que l'envoi refusera.