Языки
Все языки, на которых можно отправить сообщение. Ни параметров, ни cursor, ни scope.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
GET /languages
Все языки, на которых можно отправить сообщение. Ни параметров, ни cursor, ни scope.
Получение списка
Двести строк, целиком, в одном ответе. Запросите один раз и сохраните. Клиент, который зашивает список в код или выскребает его из документа OpenAPI, устареет в тот день, когда добавится новая строка.
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 } ]}За ключом, как и всё остальное, но без необходимости в scope: он не называет данных, принадлежащих кому-либо, а scope, охраняющий константу, только удлиняет экран согласия.
rtl здесь всегда булево значение. У шестнадцати строк оно true (арабский, иврит, персидский, урду и остальные), и тело, переведённое на один из них, составляется справа налево.
Язык
Ответ
codestring- Код BCP-47 и та форма, которую следует хранить. `translate.to` принимает и две другие, но всегда отвечает этой.
labelstring- Английское название: «Brazilian Portuguese». Приглушённая вторая строка в выпадающем списке.
nativestring- Как язык называет сам себя: «Português (Brasil)». Показывайте это ПЕРВЫМ: именно это слово ищет человек, который ищет свой язык.
flagstring- Две кодовые точки региональных индикаторов. Вспомогательный элемент для беглого просмотра рядом с самоназванием и никогда не идентификатор и не подпись сам по себе. Флаг — это страна, страна — не язык, и испанский не есть Испания, равно как английский не принадлежит Англии.
rtlboolean- Пишется ли язык справа налево. Присутствует всегда, тогда как в исходной таблице поле опускается, когда оно false.
Порядок и есть ответ
Строки приходят в порядке для выпадающего списка, и по умолчанию их не следует пересортировывать: сначала языки, на которых людям вероятнее всего пишут, затем региональные варианты, затем остальные по регионам. Сортировка по алфавиту английских названий открывает список на абхазском.
Ищите одновременно по native, label и code, а до того, как кто-то начнёт печатать, показывайте список в том виде, в каком он пришёл. translate.to принимает любую из трёх форм, поэтому выпадающий список, который хранит code и ищет по всем трём, не может выдать значение, которое отправка отклонит.