Глосарій

Терміни, які вживає це вікі, точно.

Alias (аліас) — будь-яке вхідне написання, що резолвиться в мову. Зберігається нормалізованим; глобально унікальний. Aliases and Normalisation

Base language (базова мова) — мова, чий канонічний код не несе кваліфікатора: en, de, ceb. Її власний код і є тим, що отримують провайдери; мапінг не потрібен. Це означає без кваліфікатора, а не дві літери.

BCP-47 — стандарт IETF для мовних тегів: language-Script-REGION, напр. zh-Hans-CN. Конвенція регістру, до якої канонізує сервіс.

Canonical code (канонічний код) — єдине написання мови, яке сервіс використовує й повертає. Зберігайте саме його.

Derived (виведено) — відповідь, отримана драбиною фолбеку, а не явним мапінгом. Коректна й придатна, але не курована. Будь-що з match, відмінним від exact.

Effective code (ефективний код) — те, що провайдер справді отримає для мови, явно чи виведено. ?effective=true.

Explicit mapping (явний мапінг) — налаштований рядок (провайдер, мова). Дає match: exact.

Fallback policy — по провайдеру: що відповісти для регіональної мови без явного рядка. base_language, passthrough або strict. Fallback Policies

Homoglyph (гомогліф) — символ, що виглядає ідентично іншому, як кирилична с (U+0441) і латинська c. Нормалізація виправляє ті з них, що інакше зробили б код незбіжним. Aliases and Normalisation

Lookup key (ключ пошуку) — нормалізована форма коду: нижній регістр, роздільник -. У такому вигляді аліаси зберігаються й звіряються.

match — як отримано відповідь: exact, variant, canonical, base_language, passthrough. Resolution Ladder

Provider (провайдер) — рушій перекладу, ідентифікований тим самим кодом, що й у provider_credentials: deepl_api, openai_api.

Provider alias — інший ідентифікатор, що адресує того самого провайдера, наприклад коротка назва deepl. Перелічені в полі aliases у GET /v1/providers/{code}.

Regional language (регіональна мова) — мова, чий канонічний код несе скрипт, регіон або обидва: pt-BR, zh-Hans, sr-Latn-RS. Саме щодо них провайдери не згодні.

Unsupported pair (непідтримувана пара) — пара (провайдер, мова), зафіксована як неробоча. Відповідає supported: false з code: null. Це твердження про факт, а не фолбек.

Vendor (вендор) — компанія за одним чи кількома провайдерами. Google Cloud — вендор і google_translate, і gemini_api.