Language Service Wiki
Як кожен провайдер називає кожну мову — і як це в нас спитати.
Це вікі для розробників Language Service: єдиного джерела правди про мови, які платформа вміє перекладати, і про точний рядок коду, який API кожного провайдера очікує для них.
Задача вузька й невдячна. Спрощена китайська — це zh-CN для Papago, 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" }
Без автентифікації
Тут лише відкриті довідкові дані — які мови існують і як вони називаються. API тільки на читання: немає токена, який треба отримати, і немає заголовка, який треба виставити.
Оберіть свій шлях
| Ви… | Почніть тут |
|---|---|
| Новачок — хочу, щоб один виклик просто спрацював | Quickstart |
| Рантайм перекладу, що резолвить source і target | Resolution Ladder, далі Резолвінг усієї задачі |
| Інтеграція, що приймає коди ззовні | Aliases and Normalisation, далі Нормалізація вхідних кодів |
| Шукаєте, що взагалі є | Language Catalog · Providers and Vendors |
Дві ідеї, які варто прочитати першими
Один код на пару. Для будь-якої (провайдер, мова) є рівно один рядок, який ми надсилаємо. Цей вибір зроблено один раз і зафіксовано, а не вирішується під час запиту, — тож та сама пара завжди відповідає однаково. Див. 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 Рецепти — Резолвінг мови · Резолвінг усієї задачі · Нормалізація вхідних кодів
05 Довідник — Endpoints Index · Error Codes · Glossary