api.transglot.ai/v1portanta ĵetono, unu projektoreferenco

Alŝutu dosieron. Ricevu ĉiun lingvon reen.

REST API por traduki vian aplikaĵon. Unu POST alŝutas la fontdosieron, unu GET revenigas pretan lokalon, kaj portanta ĵetono estas la tuta aŭtentikigo. Io ajn, kio parolas HTTP, povas uzi ĝin.

en: unu voko

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

300,000

vortoj monate ĉe Starter, la unua plano, kiu povas kreigi ĵetonon.

Komencu senpage Vidu la disvolvistan fasadon

60 petoj minute po ĵetono · ĉiu 429 enhavas Retry-After · uzu apartajn ĵetonojn por CI kaj produktado

la konzolo estas API-kliento

Alŝutu, traduku, kontrolu kaj elprenu, ĉiu estas REST-finpunkto.

Ĉiu vico en la suba bildo havas vojon malantaŭ si: alŝuto, kontroloj, terminaro, aroj kaj elpreno, ĉio atingebla el via propra kodo per projekt-ĵetono. La API-ludejo en la konzolo plenumas la nur-legajn operaciojn vive kontraŭ via projekto, do vi unue vidas realan respondon.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Vi alŝutas fontdosieron
POST/v1/push
La panelo de kontroloj plenigas sin
POST/v1/qa/run
Vi ŝlosas terminon
POST/v1/glossary
La vidpunkto de aroj memkontrolas sin
GET/v1/batches/:id
Vi reprenas la tradukojn
GET/v1/pull

unu vojo por panelo, 60 po minuto, kapabloj por ĵetono · elsendi viajn tradukojn ankaŭ estas finpunkto

ĝi estas simple http

Kvar aferoj, kiujn teamoj unue konstruas.

ĉiu estas ununura finpunkto kaj projekta ĵetono · neniu postulas tutan posttagmezon

kunfanda pordego · unu laborflua dosiero

Ruĝigu la peton pri kunfando kiam traduko malsukcesas.

cron · ĉiunokte

Traduku la eldonnotojn dum la nokto, ĉiunokte.

roboto · unu abono

Afiŝu al Slack tuj kiam aro finiĝas.

agento · mcp

Donu al AI-agento la samajn 17 ilojn, kiujn vi havas.

petoj po minuto

po ĵetono, ne po konto, kun Retry-After-kapo en ĉiu 429, kiu indikas kiom da sekundoj atendi.

dosierformatoj

puŝu kaj eltiru la formaton, kiun via deponejo jam uzas. Pluraloj kaj lokteniloj konserviĝas en ambaŭ direktoj. Nomu ĝin per format= en iu ajn voko.

webhook-eventoj

la tuta katalogo, ĉiu kun ekzempla ŝarĝo en la preciza formo, kiun reala liverado portas. GET /v1/webhooks/events.

mcp-iloj

la sama projekta ĵetono, donita al agenta rulmedio anstataŭ al curl. npx -y @transglot/mcp.

Oftaj demandoj

Kion programistoj demandas antaŭ la unua peto.

Kiel mi aŭtentikiĝas kun la Transglot API?

Sendu portantan ĵetonon: Authorization: Bearer $TRANSGLOT_TOKEN. La ĵetono apartenas al unu projekto, do ne estas projekta identigilo en la vojo nek konta-wide ŝlosilo, kiu povus liki. Vi kreas ĵetonojn sur la projektpaĝo kaj ĉiu portas siajn proprajn kapablojn: puŝi, eltiri, administri, legi, skribi.

Ĉu la API estas senpaga?

Ne. Portanta ĵetono komenciĝas ĉe la Starter-plano je $19 monate. Senpaga kovras la konzolon, kio sufiĉas por vidi, ĉu la produkto taŭgas, sed ĝi ne povas kreigi ĵetonon. La CLI, la GitHub Action, webhook-oj, MCP kaj la livera pakaĵo ĉiuj troviĝas malantaŭ tiu sama ĵetono, do ili alvenas kune.

Kiel mi alŝutas ĉenojn al Transglot?

POST /v1/push kun la dosiero kaj ĝia formato, ekzemple -F "file=@lang/en.json" -F "format=laravel_json". Ĝi respondas 202 kaj enmetas arojn en atendovicon. Nur la vicoj, kiuj efektive ŝanĝiĝis, estas tradukitaj, do puŝi neŝanĝitan dosieron kostas nenion.

Kiel mi rericevas miajn tradukojn?

GET /v1/pull, en iu ajn el la 20 formatoj, kiam ajn vi volas. Ĝi estas la finpunkto, kiun la CLI envolvigas, kaj tiu, kiun la API-ludejo vivas plenumas. Ne estas eksporta peto por arkivi kaj ne estas fenestro, en kiu la datumoj ĉesas esti viaj.

Kio estas la limigo de petoj al la API?

60 petoj minute, kalkulitaj po ĵetono anstataŭ po konto. Se vi superas ĝin, vi ricevas eraron 429 kun kapo Retry-After, kiu indikas, kiom da sekundoj atendi, kaj nenio estas ŝargita aŭ duone skribita. Donu apartajn ĵetonojn al CI kaj produktado por ke brua konstruo ne malsatigu vian aplikaĵon.

Kiujn lingvojn subtenas la API?

Ne ekzistas fiksa listo. La validigilo akceptas ajnan BCP-47 etikedon, kiun ICU rekonas, kio estas 708 lokaloj en la tabelo, kontraŭ kiu ĝi kontrolas, plus struktura rezerva solvo por etikedoj ekster ĝi. Aldonu lokalon al la projekto kaj la sekva puŝo inkluzivos ĝin.

Kiujn dosierformatojn mi povas puŝi kaj eltiri?

Dudek: JSON plata kaj nestita, Laravel PHP kaj JSON, Android XML, iOS .strings, .stringsdict kaj .xcstrings, Flutter ARB, XLIFF 1.2 kaj 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV kaj Unreal PO. Sep el ili portas pluralojn, kaj la dosiero revenas en la formo, en kiu ĝi iris.

Ĉu Transglot havas rethokojn?

Jes. Ekzistas 12 eventoj de rethokoj, inkluzive de batch.completed, translation.reviewed, qa.completed kaj source_drift.repaired. Ĉiu livero estas HMAC-subskribita kun tempmarka kapo, por ke vi povu verifi ĝin, kaj GET /v1/webhooks/events redonas la katalogon kun specimenaj ŝarĝoj por ĉiu el ili.

Ĉu ekzistas MCP-servilo por AI-agentoj?

Jes. npx -y @transglot/mcp eksponas 17 ilojn per via projekta ĵetono, do asistanto povas legi tradukon, skribi ĝin, aldoni lingvon, komenci ruladon, kontroli arojn aŭ redakti la glosaron. Temas pri la sama API kaj la samaj permesoj, atingitaj de agenta rultempo anstataŭ de curl.

Ĉu mi povas ĝin lanĉi en CI?

Jes. La GitHub-ago (transglot/transglot-action@v1) kaj la CLI ambaŭ pakas ĉi tiujn finpunktojn. Kiam linio estas rifuzita, transglot push --wait eliras kun kodo 4 kaj la Ago malsukcesigas sian taskon en tiu rulado. Por haltigi kunfandon, rulu ĝin sur petoj de tirpetoj kun ties enigo de konfirmo starigita al nenio, aldonu paŝon, kiu malsukcesas kiam mankas ŝlosilo en tirita dosiero, kaj igu la taskon deviga kontrolo en branĉprotekto.

Kio okazas, kiam traduko malsukcesas kvalitan kontrolon?

Kvar determinismaj pordegoj legas ĉiun linion: lokokupiloj, pluraloj, glosaraj terminoj kaj longo. Rompita lokokupilo, mankanta plurala formo aŭ malpermesita glosara termino ricevas unu aŭtomatan korektan reprovon, kaj se ĝi ankoraŭ malsukcesas, la linio estas rifuzita anstataŭ skribita. Linio, kiu nur superas sian longon, estas skribita, ne rifuzita. GET /v1/batches/:id?include=failures listigas la rifuzitajn liniojn kaj la kialon.

Ĉu la API iam rompos mian integriĝon?

Ne. /v1 nur iam akiras finpunktojn kaj respondkampojn; kampo, kiun vi jam analizas, ne ŝanĝas formon aŭ malaperas. Rompa ŝanĝo estus liverita sub nova versia prefikso, kiu estas rezervita kaj ankoraŭ malplena. La API-ŝanĝprotokolo registras ĉiun eldonon.