Головна/Адмінка/Редагування матриці ENУКРРУС API-довідник (ReDoc) ↗

Редагування матриці

Один провайдер, усі мови, по редагованій комірці на кожну — робота сервісу, зроблена видимою.

Admin → Providers → провайдер → Matrix, або одразу /admin/providers/deepl_api/matrix.

По рядку на мову, з кодом, який цей провайдер справді отримає, і з тим, звідки цей код узявся.

Як читати рядок

Колонка Що
Language назва й посилання на сторінку мови
Our code канонічний код — те, що ви зберігаєте
Sent to provider редагована комірка: що піде в запит
Source як це отримано — той самий match, що й в API

Рамка комірки одразу каже про її стан:

  • суцільна зелена — закріплено. Хтось налаштував це свідомо.
  • пунктирна сіра — виведено. Воно вже працює, просто не куроване.
  • бурштинова — відредаговано, ще не збережено.

Редагування

Введіть код і клікніть поза комірку. Це вся взаємодія — комірка зберігається на blur, один запит на правку, рядок перемальовується з новим match. Позиція скролу й фільтри зберігаються, і саме тому це не сабміт форми.

Enter зберігає, Escape відкочує.

Очистіть поле, щоб відкріпити: явний рядок видаляється, і пара повертається до драбини фолбеку.

✕ Unsupported фіксує, що пара не працює. Тоді /v1/resolve відповідає supported: false з code: null, і викликачі знають, що пробувати не варто.

↺ Unpin з'являється лише на закріплених рядках.

Працює без JavaScript

За кожним інлайн-контролом стоїть звичайна форма на сторінці мови. Ніщо тут не залежить критично від скриптів.

Фільтри

Search шукає по назві, канонічному коду й аліасах. Show звужує до закріплених, виведених або непідтримуваних — корисний саме derived: це список пар, які ніхто не перевіряв.

Kind фільтрує base проти regional. Базові мови майже ніколи не варто закріплювати: їхній власний код і є відповіддю.

Коли закріплювати

Закріплюйте, коли провайдер хоче те, чого драбина не дає. Конкретно:

  • провайдер має нестандартний набір кодів — Baidu хоче cht для традиційної китайської, а не zh
  • провайдер розрізняє варіант, який драбина склеює — DeepL приймає EN-GB і EN-US, але en-GB виводиться в en
  • провайдер хоче незвичний регістр — деякі API хочуть PT-BR, а не pt-BR

Не закріплюйте значення, ідентичне тому, що вже показано. Це додає рядок для підтримки й нічого не міняє.

Масові операції

Copy mappings (на сторінці налаштувань провайдера) клонує всі закріплені коди з іншого провайдера. Підключення рушія, що говорить тим самим набором кодів, що й уже налаштований, стартує з його таблиці замість сотні ручних правок. Позначте overwrite, щоб замінити вже закріплені коди на цільовому; лишіть незазначеним, щоб заповнити лише прогалини.

Скопійовані рядки позначаються як copied:<source> у полі джерела, тож згодом їх видно окремо від перевірених вручну.

Перевірка

На сторінці Tools є живий тестер на тому самому коді, що й публічний ендпоінт. Або перевірте публічний API напряму — правка видима наступним запитом:

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

Далі