Idiomas
Todos los idiomas en los que se puede enviar un mensaje. Sin parámetros, sin cursor, sin scope.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
GET /languages
Todos los idiomas en los que se puede enviar un mensaje. Sin parámetros, sin cursor, sin scope.
Listarlos
Doscientas filas, completas, en una sola respuesta. Descárgala una vez y consérvala. Un cliente que codifique la lista de forma fija o la extraiga del documento OpenAPI queda desactualizado el día en que se añade 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 } ]}Detrás de una clave como todo lo demás y sin necesidad de scope: no nombra datos de nadie, y un scope que proteja una constante solo alarga la pantalla de consentimiento.
rtl siempre es un boolean aquí. Dieciséis filas tienen true (árabe, hebreo, persa, urdu y las demás), y un cuerpo traducido a uno de esos idiomas se compone de derecha a izquierda.
Un idioma
Respuesta
codestring- El código BCP-47, y la forma que conviene almacenar. `translate.to` también acepta las otras dos y siempre responde con esta.
labelstring- El nombre en inglés: "Brazilian Portuguese". La segunda línea atenuada en un selector.
nativestring- Cómo se llama el idioma a sí mismo: "Português (Brasil)". Muéstralo PRIMERO: es la palabra que realmente busca alguien que busca su propio idioma.
flagstring- Dos puntos de código de indicador regional. Una ayuda visual junto al nombre nativo y nunca un identificador ni una etiqueta por sí sola. Una bandera es un país, un país no es un idioma, y el español no es España, igual que el inglés no pertenece a Inglaterra.
rtlboolean- Si el idioma se escribe de derecha a izquierda. Siempre presente, mientras que la tabla subyacente lo omite cuando es false.
El orden es la respuesta
Las filas llegan en el orden del selector y no conviene reordenarlas por defecto: primero los idiomas en los que es más probable que se escriba a alguien, después las variantes regionales y luego el resto por región. El orden alfabético por nombre en inglés abre el selector en Abkhaz.
Busca sobre native, label y code a la vez, y muestra la lista tal como llega hasta que alguien escriba. translate.to acepta cualquiera de los tres, así que un selector que almacene code y busque en los tres no puede producir un valor que el envío rechace.