Главная/Рецепты/Резолвинг языка ENУКРРУС API-справочник (ReDoc) ↗

Резолвинг языка

Один вызов, с объяснением каждого поля ответа.

Цель: у вас есть провайдер и какое-то написание языка. Нужна строка для отправки.

curl "https://languages.service.custom.mt/v1/resolve?provider=deepl_api&language=pt_BR"

{
  "query": "pt_BR",
  "provider": "deepl_api",
  "language": "pt-BR",
  "code": "PT-BR",
  "supported": true,
  "match": "exact",
  "matched_alias": null,
  "via_language": null
}
Поле Для чего
code ответ — положить в запрос к провайдеру
language канонический код — хранить именно его, а не query
supported false означает «запрос не делать»
match насколько надёжен ответ — см. Resolution Ladder
matched_alias какой алиас сработал, когда query не был каноническим
via_language какой язык дал код, для variant / base_language

Python

import httpx

BASE = "https://languages.service.custom.mt"


def provider_code(provider: str, language: str) -> str:
    response = httpx.get(
        f"{BASE}/v1/resolve", params={"provider": provider, "language": language}, timeout=5.0
    )
    response.raise_for_status()
    body = response.json()
    if not body["supported"]:
        raise ValueError(f"{provider} не поддерживает {body['language']}")
    return body["code"]

Два режима отказа

Неизвестный код — 404 с error.code == "language_not_found". Либо код действительно неизвестен, либо ему нужен алиас; см. Добавить язык.

Известная пара, отказано — 200 с supported: false и code: null. Кто-то зафиксировал, что эта пара не работает. Пропустите провайдера, не ретрайте.

try:
    code = provider_code("deepl_api", raw_code)
except httpx.HTTPStatusError as exc:
    if exc.response.status_code == 404:
        log.warning("unknown language code", extra={"code": raw_code})
        return None
    raise

Не пропускайте вызов, когда код «выглядит нормально»

pt-BR выглядит нормально и нормален для DeepL. Для Amazon это pt. Смысл постоянного вызова в том, что ваш код перестаёт знать, какие провайдеры привередливы.

Далее