Language Service Wiki
Як кожен провайдер називає кожну мову — і як це в нас спитати.
Це вікі для розробників Language Service: єдиного джерела правди про мови, які платформа вміє перекладати, і про точний рядок коду, який API кожного провайдера очікує для них.
Задача вузька й невдячна. Спрощена китайська — це zh-CN для Yandex, zh-Hans для DeepL і Azure, zh-Hans-CN ще для кількох. Бразильська португальська приходить з інтеграцій як pt-BR, pt_BR, PT-BR або por-br. Помилка тут — це не помилка валідації, яку видно на тестах: це або задача, що впала на боці провайдера, або, що гірше, задача, яка тихо повернулась перекладеною не в той варіант.
Отже: надішліть будь-яке написання і провайдера — отримайте точний рядок, який треба покласти в запит.
GET /v1/resolve?provider=deepl_api&language=pt_BR
{ "query": "pt_BR", "provider": "deepl_api", "language": "pt-BR",
"code": "PT-BR", "supported": true, "match": "exact" }
Без автентифікації
Тут лише відкриті довідкові дані — які мови існують і як вони називаються. Немає токена, який треба отримати, і немає заголовка, який треба виставити. Редагування каталогу — інша річ: воно за логіном на /admin.
Оберіть свій шлях
| Ви… | Почніть тут |
|---|---|
| Новачок — хочу, щоб один виклик просто спрацював | Quickstart |
| Рантайм перекладу, що резолвить source і target | Resolution Ladder, далі Резолвінг усієї задачі |
| Інтеграція, що приймає коди ззовні | Aliases and Normalisation, далі Нормалізація вхідних кодів |
| Переводите виклики з хелперів консолі | Migrating from the Console |
| Курируєте каталог | Admin Panel · Editing the Matrix |
| Запускаєте або деплоїте сервіс | Deployment · Rebuilding the Seed |
Дві ідеї, які варто прочитати першими
Один код на пару. Для будь-якої (провайдер, мова) є рівно один рядок, який ми надсилаємо. Легасі-консоль дозволяла кілька і брала той рядок, який база повернула першим — 330 пар були неоднозначними саме так. Див. Core Concepts.
Кожна відповідь каже, як вона отримана. match відрізняє налаштований мапінг від розумного фолбеку, тож викликач, якому потрібна точність, бачить різницю. Див. Resolution Ladder.
Довідник API
Інтерактивний ReDoc віддає сам API. Однорядковий опис кожної операції з посиланнями на сторінки — Endpoints Index.
Карта розділів
00 Початок роботи — Quickstart · Core Concepts · Errors and Conventions
01 Мови — Language Catalog · Aliases and Normalisation
02 Провайдери — Providers and Vendors · Fallback Policies
03 Резолвінг — Resolution Ladder
04 Адмінка — Admin Panel · Editing the Matrix
05 Інтеграція — Migrating from the Console
06 Експлуатація — Deployment · Rebuilding the Seed
07 Рецепти — Резолвінг мови · Резолвінг усієї задачі · Нормалізація вхідних кодів · Закріпити код провайдера · Додати мову · Підключити провайдера
08 Довідник — Endpoints Index · Error Codes · Glossary