Глоссарий

Термины, которые употребляет эта вики, точно.

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.