Що дає API і чого воно не дасть
Що можна робити через API BDO UA Translate: читати рядки Black Desert, брати контекст і глосарій, надсилати переклади. Які межі діють і чому ключ не дає більше за вашу роль.
API дає програмний доступ до тієї самої бази, з якою люди працюють на сайті: читати рядки гри, брати контекст і терміни, надсилати переклади. Усе, що заборонено людині в браузері, заборонено й ключу.
Показати на весь екранКому це потрібно
- Ви пишете власного ШІ-агента або скрипт, який перекладає пачками.
- Ви хочете звіряти свої тексти з нашим глосарієм, не відкриваючи сайт.
- Ви робите інструмент для спільноти й вам потрібні чесні дані про прогрес.
Якщо ви просто хочете перекладати руками · API не потрібен узагалі, почніть звідси.
Головне правило
Ключ ніколи не має більше прав, ніж роль його власника. Здатності в ключі не додають повноважень · вони лише звужують те, що роль і так дозволяє. Тому звичайний перекладач через API так само подає пропозиції на модерацію, а не пише готовий переклад у гру.
Це не налаштування, а перевірка на сервері: клієнт не є довіреною стороною.
Що API робить за вас
- Не дає зіпсувати гру. Кожен запис проходить перевірку розмітки: втрачена
вставка
{KeyBind:…}не збережеться навіть із правами адміністратора. - Не дає перекладати службові рядки. Рядки, у яких немає що перекладати
(
<null>, самі системні вставки, порожній оригінал), у вибірку не потрапляють, а прямий запис у них отримує відмову. - Каже, коли не знає. Якщо контекст рядка ще не проіндексований, відповідь
чесно каже
indexed: false, а не вдає, що термінів немає.
Чого API не дає
- Створювати нові терміни глосарія «з тексту» · лише через підтверджену identity сутності й модерацію.
- Обходити модерацію: роль без права прямого запису отримує пропозицію, і жодне поле в запиті цього не змінює.
- Тягнути базу цілком: вибірка курсорна, з лімітом на сторінку.
З чого почати
- Перший запит за пʼять хвилин
- Скільки роботи в патчі
- Як брати рядки в роботу
- Не перекладайте те, що вже перекладено
- Звідки брати контекст і назви
- Як надіслати переклад і що робити з відмовою
- Модерація через API · якщо ваша роль ухвалює рішення
Готовий клієнт, який усе це вже робить, лежить у відкритому репозиторії bdo-ua-ai-localization · його можна читати як приклад послідовності викликів.