api.transglot.ai/v1bearer token, isang proyektoreference

Mag-push ng file. Makuha ang bawat wika pabalik.

Isang REST API para sa pag-translate ng iyong app. Isang POST ang nag-u-upload ng source file, isang GET ang nagbabalik ng tapos na locale, at ang bearer token ang buong authentication. Anumang nakakausap ng HTTP ay maaaring gumamit nito.

sa: isang tawag

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

out

300,000

mga salita bawat buwan sa Starter, ang unang plano na maaaring gumawa ng token.

Magsimula nang libre Tingnan ang developer surface

60 request bawat minuto bawat token · may Retry-After ang bawat 429 · gumamit ng hiwalay na token para sa CI at production

ang console ay isang api client

Push, translate, gate at pull, bawat isa ay isang REST endpoint.

Ang bawat row sa larawan sa ibaba ay may kaukulang route: push, gates, glossary, batches at pull, lahat ay ma-access mula sa iyong sariling code gamit ang project token. Ang API playground sa console ay live na nagpapatakbo sa mga read-only na feature laban sa iyong proyekto, kaya makikita mo muna ang tunay na response.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Nag-u-upload ka ng source file
POST/v1/push
Napupuno ang gates panel
POST/v1/qa/run
Nag-lock ka ng term
POST/v1/glossary
Pinoll ng batch view ang sarili nito
GET/v1/batches/:id
Kinukuha mo pabalik ang mga translation
GET/v1/pull

isang ruta bawat panel, 60 kada minuto, mga kakayahan bawat token · ang paglabas ng iyong mga pagsasalin ay isang endpoint din

http lang ito

Apat na bagay na unang binubuo ng mga team.

bawat isa ay iisang endpoint at isang project token · walang isa rito na kumakain ng buong hapon

merge gate · isang workflow file

Gawing pula ang pull request kapag nabigo ang pagsasalin.

cron · gabi-gabi

Isalin ang mga release notes habang natutulog, araw-araw.

bot · isang subscription

Mag-post sa Slack agad pagkatapos ng isang batch.

agent · mcp

Bigyan ang AI agent ng parehong 17 na tool na meron ka.

mga request kada minuto

bawat token, hindi bawat account, na may Retry-After header sa bawat 429 na nagsasaad kung ilang segundo ang hintayin.

mga format ng file

i-push at i-pull ang format na ginagamit na ng iyong repository. Mananatili ang mga plural at placeholder sa parehong direksyon. Pangalanan ito gamit ang format= sa alinmang tawag.

mga event ng webhook

ang buong katalogo, bawat isa ay may halimbawa ng payload na eksaktong katulad ng tunay na delivery. GET /v1/webhooks/events.

mga tool ng mcp

parehong project token, ibinigay sa agent runtime imbes na sa curl. npx -y @transglot/mcp.

Mga FAQ

Ang tinatanong ng mga developer bago ang unang request.

Paano ako mag-aauthenticate sa Transglot API?

Magpadala ng bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Ang token ay para sa isang project, kaya walang project id sa path at walang account-wide key na maile-leak. Gawa ka ng mga token sa project page at bawat isa ay may sariling mga kakayahan: push, pull, manage, read, write.

Libre ba ang API?

Hindi. Ang bearer token ay nagsisimula sa Starter plan na $19 bawat buwan. Sakop ng libre ang console, na sapat upang makita kung akma ang produkto, pero hindi ito pwedeng gumawa ng token. Ang CLI, GitHub Action, webhooks, MCP at ang delivery bundle ay nasa likod ng parehong token, kaya sabay-sabay silang dumadating.

Paano ako mag-u-upload ng mga string sa Transglot?

POST /v1/push kasama ang file at ang format nito, halimbawa -F "file=@lang/en.json" -F "format=laravel_json". Sagot nito ay 202 at i-queue ang isang batch. Tanging mga row na talagang nagbago ang isasalin, kaya walang bayad ang pag-push ng file na walang pagbabago.

Paano ko maibabalik ang aking mga pagsasalin?

GET /v1/pull, sa alinman sa 20 format, kahit kailan mo gusto. Ito ang endpoint na binabalot ng CLI, at ang pinapatakbo nang live ng API playground. Walang export request na kailangan i-file at walang panahon kung saan hindi na sa iyo ang data.

Ano ang rate limit ng API?

60 na request bawat minuto, binibilang kada token sa halip na kada account. Kapag nalampasan ito, makakakuha ka ng 429 na may Retry-After header na nagsasaad kung ilang segundo ang hihintayin, at walang singilin o bahagyang isusulat. Gumamit ng hiwalay na token para sa CI at production upang hindi maubos ng maingay na build ang iyong app.

Aling mga wika ang sinusuportahan ng API?

Walang nakapirmeng listahan. Tinatanggap ng validator ang anumang BCP-47 tag na kinikilala ng ICU, na bumababa sa 708 locale sa tinalasang talahanayan, kasama ang structural fallback para sa mga tag na wala roon. Magdagdag ng locale sa proyekto at isasama ito sa susunod na push.

Aling mga format ng file ang maaari kong i-push at i-pull?

Dalawampu: JSON flat at nested, Laravel PHP at JSON, Android XML, iOS .strings, .stringsdict at .xcstrings, Flutter ARB, XLIFF 1.2 at 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV at Unreal PO. Pito rito ay nagdadala ng plurals, at ibabalik ang file sa anyong pumasok ito.

Mayroon bang webhooks ang Transglot?

Oo. May 12 na webhook event, kabilang ang batch.completed, translation.reviewed, qa.completed at source_drift.repaired. Ang bawat delivery ay may HMAC signature na may timestamp header kaya maaari mong beripikahin ito, at ang GET /v1/webhooks/events ay nagbabalik ng katalogo na may sample payload para sa bawat isa.

Mayroon bang MCP server para sa mga AI agent?

Oo. Ang npx -y @transglot/mcp ay naglalantad ng 17 na tool gamit ang iyong project token, kaya maaaring magbasa ng translation, sumulat ng isa, magdagdag ng wika, magsimula ng run, suriin ang batch, o i-edit ang glossary ang assistant. Ito ay parehong API at parehong mga permiso, na inaakses mula sa agent runtime imbes na mula sa curl.

Maaari ko ba itong patakbuhin sa CI?

Oo. Ang GitHub Action (transglot/transglot-action@v1) at ang CLI ay parehong gumagamit ng mga endpoint na ito. Kapag tinanggihan ang isang row, ang transglot push --wait ay aalis sa exit code 4 at mag-fail ang job ng Action sa nasabing run. Upang pigilan ang merge, patakin ito sa pull requests na may commit input na naka-set sa none, magdagdag ng step na mag-fail kapag walang key ang pulled file, at gawing required check ang job sa branch protection.

Ano ang mangyayari kapag nabigo ang translation sa quality check?

Apat na deterministic gate ang bumabasa sa bawat row: placeholders, plurals, glossary terms, at length. Ang broken placeholder, missing plural form, o forbidden glossary term ay kusang susubukang ayusin nang isang beses, at kung hindi pa rin matagumpay, itatanggi ang row imbes na isulat. Ang row na lumampas lamang sa length ay isusulat, hindi itatanggi. Ang GET /v1/batches/:id?include=failures ay naglilista ng mga tinanggihang row at dahilan nito.

Babasagin ba ng API ang aking integration balang araw?

Hindi. Ang /v1 ay lalo lang makakakuha ng mga endpoint at response field; ang field na iyong pin-parse ay hindi magbabago ng anyo o mawawala. Ang breaking change ay ilalabas sa ilalim ng bagong version prefix, na nakareserba at patuloy na walang laman. Itinatala ng API changelog ang bawat release.