Качете файл. Върнете всеки език обратно.

Изпратете bearer токен: Authorization: Bearer $TRANSGLOT_TOKEN. Токенът принадлежи към един проект, затова няма project id в пътя и няма ключ за цял акаунт, който да бъде компрометиран. Създавате токени от страницата на проекта и всеки от тях има свои собствени права: push, pull, manage, read, write.

Не. Bearer токенът започва от план Starter на цена $19 на месец. Безплатният план покрива конзолата, което е достатъчно, за да прецените дали продуктът ви подхожда, но не позволява създаване на токен. CLI, GitHub Action, уебхуковете, MCP и пакетът за доставка са зад същия токен, затова всички те стават достъпни едновременно.

POST /v1/push с файла и неговия формат, например -F "file=@lang/en.json" -F "format=laravel_json". Отговорът е 202 и задачата се поставя на опашка. Превеждат се само редовете, които действително са променени, затова качването на непроменен файл не струва нищо.

GET /v1/pull, във всеки от 20-те формата, когато пожелаете. Това е крайната точка, която CLI обвива и която API playground изпълнява на живо. Няма нужда от заявка за експорт и няма период, през който данните да престанат да бъдат ваши.

60 заявки в минута, броени за токен, а не за акаунт. При надвишаване получавате 429 със заглавка Retry-After, указваща колко секунди да изчакате, и нищо не се таксува или записва частично. Използвайте отделни токени за CI и продукция, за да предотвратите блокиране на приложението от шумни билдове.

Няма фиксиран списък. Валидаторът приема всеки BCP-47 таг, разпознат от ICU, което са 708 локала в таблицата, срещу която се проверява, плюс структурен резервен вариант за тагове извън нея. Добавете локал към проекта и следващото качване ще го включи.

Двадесет: JSON плосък и вложен, Laravel PHP и JSON, Android XML, iOS .strings, .stringsdict и .xcstrings, Flutter ARB, XLIFF 1.2 и 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV и Unreal PO. Седем от тях поддържат множествено число и файлът се връща в същата структура, в която е изпратен.

Да. Има 12 уебхук събития, включително batch.completed, translation.reviewed, qa.completed и source_drift.repaired. Всяка доставка е подписана с HMAC и съдържа времеви печат в заглавката, за да можете да я верифицирате, а GET /v1/webhooks/events връща каталога с примерен payload за всяко от тях.

Да. npx -y @transglot/mcp предоставя 17 инструменти чрез вашия проектен токен, така че асистентът може да чете превод, да пише такъв, да добавя език, да стартира изпълнение, да проверява партида или да редактира терминологията. Това е същото API и същите разрешения, достъпни от среда за изпълнение на агент вместо от curl.

Да. GitHub Action (transglot/transglot-action@v1) и CLI обвиват тези крайни точки. Когато ред бъде отказан, transglot push --wait завършва с код 4 и Action проваля задачата за това изпълнение. За да спрете сливане, го стартирайте при заявки за изтегляне (pull requests), като зададете входния параметър за commit на none, добавете стъпка, която се проваля, когато липсва ключ в изтеглен файл, и направете задачата задължителна проверка в защитата на клоните.

Четири детерминирани контролни точки проверяват всеки ред: заместители, множествено число, термини от терминологията и дължина. Повреден заместител, липсваща форма за множествено число или забранен термин от терминологията получават едно автоматично коригиращо повторение, а ако все още има грешка, редът се отказва, вместо да бъде записан. Ред, който само надхвърля допустимата дължина, се записва, а не се отказва. GET /v1/batches/:id?include=failures изброява отказаните редове и причините за това.

Не. /v1 само добавя крайни точки и полета в отговорите; поле, което вече анализирате, не променя структурата си и не изчезва. Критична промяна би била пусната под нов префикс на версията, който е резервиран и все още е празен. Дневникът на промените в API записва всяко издание.