api.transglot.ai/v1bearer token፣ አንድ ፕሮጀክትማጣቀሻ

ፋይል ይግፉ። እያንዳንዱን ቋንቋ ይመልሱ።

አፕዎን ለመተርጎም REST API። አንድ POST የምንጭ ፋይሉን ያስገባል፣ አንድ GET የተጠናቀቀ ቦታ (locale) ይመልሳል፣ እና bearer token ሙሉው የማጣጣም (auth) ነው። HTTP የሚናገር ማንኛውም ነገር ሊያንቀሳቅሰው ይችላል።

በ: አንድ ጥሪ

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

ቃላት በወር በ Starter ላይ፣ token ሊፈጥር የሚችል የመጀመሪያ እቅድ።

ነፃ ይጀምሩ የአበል (developer) ገጽታን ይመልከቱ

በአንድ token በደቂቃ 60 ጥሪዎች · እያንዳንዱ 429 Retry-After ይይዛል · ለ CI እና ለ production የተለያዩ tokens ይስጡ

ኮንሶል api ደንጋጌ (client) ነው

ይግፉ፣ ይተርጉሙ፣ ይግቱ እና ይጎትቱ፣ እያንዳንዱ REST endpoint ነው።

ከዚህ በታች ባለው ምስል ውስጥ ያለው እያንዳንዱ መስመር የራሱ መንገድ (route) አለው፡ push፣ gates፣ glossary፣ batches እና pull፣ ሁሉም ከፕሮጀክት ቶክን ጋር ከራስዎ ኮድ ሊደረስባቸው ይችላሉ። በኮንሶል ውስጥ ያለው API playground read-only የሆኑትን በቀጥታ ከፕሮጀክትዎ ጋር ያሄዳል፣ ስለዚህ እውነተኛ ምላሽን በመጀመሪያ ያዩ።

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

የምንጭ ፋይል ያስገቡ
POST/v1/push
የgates ፓነል ይሞላል
POST/v1/qa/run
አንድ ቃል ይቆልፉ
POST/v1/glossary
የbatch እይቫ ራሷን ይፈትሻለች
GET/v1/batches/:id
ትርጉማዎቹን ይመልሱ
GET/v1/pull

ለእያንዳንዱ ፓነል አንድ መንገድ፣ በደቂቃ 60፣ ችሎታዎች በቶክን · ትርጉማዎችዎን ማውጣትም endpoint ነው

http ብቻ ነው

ቡድኖች በመጀመሪያ የሚገነቡት አራት ነገሮች።

እያንዳንዱ አንድ endpoint እና የፕሮጀክት ቶክን ነው · ማንኛውም ከእነሱ አንድ ቀን አይወስድም

የመዋሃድ መግቢያ · አንድ የስራ ሂደት ፋይል

ትርጉም ሲሳካት pull request ቀይ ያድርጉ።

cron · በየሌሊቱ

የልቀት ማስታወሻዎችን በየሌሊቱ ይተርጉሙ።

bot · አንድ ደንበኝነት

batch ሲጠናቀቅ ወዲያውኑ ወደ Slack ይለጥፉ።

agent · mcp

ለ AI ወኪል እርስዎ ካሏቸው 17 መሳሪያዎችን ይስጡ።

ጥያቄዎች በደቂቃ

በቶክን፣ እንጂ በአካውንት አይደለም፣ በእያንዳንዱ 429 ላይ ምን ያህል ሰከንድ መጠበቅ እንዳለበት የሚገልጽ Retry-After header አለ።

የፋይል ቅርጸቶች

ሪፖዚቶሪዎ አስቀድሞ የሚጠቀመውን ቅርጸት push እና pull ያድርጉ። Plurals እና placeholders በሁለቱም አቅጣጫ ይቆያሉ። በማንኛውም ጥሪ format= በመጠቀም ይሰይሙት።

webhook ክስተቶች

ሙሉ ካታሎግ፣ እያንዳንዱ በእውነተኛ አቅርቦት ቅርጸት ምሳሌ payload አለው። GET /v1/webhooks/events።

mcp መሳሪያዎች

ተመሳሳይ የፕሮጀክት ቶክን፣ ወደ curl ከመስጠት ይልቅ ወደ agent runtime ይሰጣል። npx -y @transglot/mcp።

ተደጋግሞ የሚጠየቁ ጥያቄዎች

ገንቢዎች ከመጀመሪያ ጥያቄ በፊት የሚጠይቋቸው።

How do I authenticate with the Transglot API?

Send a bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. The token belongs to one project, so there is no project id in the path and no account-wide key to leak. You create tokens on the project page and each one carries its own abilities: push, pull, manage, read, write.

API ነጻ ነው?

አይደለም። Bearer ቶክን በStarter እቅድ በወር $19 ይጀምራል። ነጻው እቅድ ኮንሶሉን ያጠቃልላል፤ ይህም ምርቱ የሚስማማ መሆኑን ለማየት በቂ ነው፣ ነገር ግን ቶክን ማምረት አይችልም። CLI፣ GitHub Action፣ webhooks፣ MCP እና የማቅረብ ጥቅል (delivery bundle) ሁሉም በዚያው ቶክን ስር ይገኙ፣ ስለዚህ አብረው ይመጡ።

ስትሪንጎችን ወደ Transglot እንዴት እጫን?

POST /v1/push ከፋይሉ እና ከቅርጹ (format) ጋር፣ ለምሳሌ -F "file=@lang/en.json" -F "format=laravel_json"። 202 ምላሽ ይሰጣል እና ባች (batch) ወደ ስራ ዝርዝር ያስገባል። በእውነት የተቀየሩት ረድፎች ብቻ ይተረጎማሉ፣ ስለዚህ ያልተቀየረ ፋይል መጫን ምንም አይጠይቅም።

ትርጉሞቼን እንዴት መልሼ ማውጣት እችላለሁ?

GET /v1/pull፣ ከ20 ቅርጾች ውስጥ በማንኛውም፣ በምትፈልጉት ጊዜ። ይህ CLI የሚጠቀምበት ነጥብ ሲሆን፣ API መጫወቻ (playground) በቀጥታ የሚያስኬደውም ይሄ ነው። ለመላክ የሚጠይቅ ጥያቄ የለም እና ውሂቡ የእርስዎ መሆኑን የሚያቋርጥ ጊዜ የለም።

የAPI የጥያቄ ገደብ (rate limit) ምንድን ነው?

በደቂቃ 60 ጥያቄዎች፣ በአካውንት ሳይሆን በቶክን ይቆጠራል። ከዚህ በላይ ከሆነ፣ ምን ያህል ሰከንድ መጠበቅ እንዳለቦት የሚያሳይ Retry-After ራስጌ (header) ያለው 429 ስህተት ይቀበሉ፣ እና ምንም አይከፈልም ወይም ግማሽ አይጻፍም። ለCI እና ለproduction የተለያዩ ቶኖች ይስጡ፤ አንድ ጫጫታ ያለው ግንባታ (noisy build) አፕሊኬሽንዎን አያጠፋውም።

API ምን ቋንቋዎችን ይደግፋል?

ቋሚ ዝርዝር የለም። ተፈጻሚው (validator) ICU የሚያውቃቸውን ማንኛውንም BCP-47 መለያ (tag) ይቀበላል፤ ይህም በሚያጣራበት ሰንጠረዥ ውስጥ 708 አካባቢዎች (locales) ሲሆን፣ ከዚህ ውጪ ላሉ መለያዎች መዋቅራዊ ተፈጻሚ (structural fallback) አለ። አካባቢ (locale) ወደ ፕሮጀክቱ ያክሉ፤ ቀጣዩ ግፊት (push) ያካትተዋል።

ምን ዓይነት ፋይል ቅርጾችን መጫን እና ማውጣት እችላለሁ?

ሃያ፡ JSON ጠፍጣፋ እና ተደራራቢ (nested)፣ 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። ከነዚህ ውስጥ ሰባቱ ብዙ ቁጥር (plurals) ይይዛሉ፣ እና ፋይሉ የገባበት ቅርጽ ሆኖ ይመለሳል።

Transglot webhooks አሉት?

አዎ። 12 የwebhook ክስተቶች አሉ፣ ከነዚህም ውስጥ batch.completed፣ translation.reviewed፣ qa.completed እና source_drift.repaired ይገኙበታል። እያንዳንዱ ማቅረብ HMAC የተፈረመ እና የጊዜ ማህተም (timestamp) ራስጌ ያለው ስለሆነ ማረጋገጥ ይችሉ፣ እና GET /v1/webhooks/events ካታሎጉን ከእያንዳንዳቸው ናሙና ጭነት (payload) ጋር ይመልሳል።

ለAI ወኪሎች (agents) MCP ሰርቨር አለ?

አዎ። npx -y @transglot/mcp በፕሮጀክት ቶክንዎ ላይ 17 መሳሪያዎችን ያቀርባል፤ ስለዚህ አሲስታንት ትርጉምን ማንበብ፣ መጻፍ፣ ቋንቋ መጨመር፣ ሩን መጀመር፣ ባች ማጣራት ወይም የቃላት ዝርዝር (glossary) ማስተካከል ይችላል። ይህ ተመሳሳይ API እና ተመሳሳይ ፈቃዶች ናቸው፤ ከ curl ይልቅ ከወኪል አሠራር (agent runtime) የሚደረስባቸው።

በCI ውስጥ ማስኬድ እችላለሁ?

አዎ። የ GitHub Action (transglot/transglot-action@v1) እና CLI ሁለቱም እነዚህን መጨረሻ ነጥቦች (endpoints) ይጠቅሙ። አንድ ረድፍ ሲቀበል፣ transglot push --wait 4 ሆኖ ይወጣል እና Action በዚያ ሩን ላይ ስራውን ያስተጓጉላል። መዋሃድን ለማስቆም፣ በ pull requests ላይ ያስኬዱት፤ commit input ወደ none ያዘጋጁት፤ የተጎተተ ፋይል ቁልፍ (key) ከጎደለ የሚሳከት ደረጃ ይጨምሩ፤ እና ስራውን በቅርንጫፍ ጥበቃ (branch protection) ውስግ አስፈላጊ ምርመራ ያድርጉት።

ትርጉም የጥራት ምርመራን ሲሸፍን ምን ይከሰታል?

አራሽ ቋሚ መግቢያዎች (gates) እያንዳንዱን ረድፍ ያነቡ፡ placeholders፣ plurals፣ የቃላት ዝርዝር (glossary) ቃላት እና ርዝመት። የተሰበረ placeholder፣ የጎደለ plural ቅጽ ወይም የተከለከለ የቃላት ዝርዝር ቃል አንድ አውቶማቲክ የማስተካከል እንደገና ሙከራ ያገኛል፤ እንደገና ቢሳከትም ረድፉ ከመጻፍ ይልቅ ይቀበል። ርዝመቱን ብቻ ያልፈ ረድፍ ይጻፋል እንጂ አይቀበልም። GET /v1/batches/:id?include=failures የተቀበሉትን ረድፎች እና ምክንያቶቹን ያሳያል።

API የእኔን ውህደት (integration) ያበላሽ ይሆን?

አይደለም። /v1 የሚጨምረው ነጥቦችን እና የምላሽ መስኮችን ብቻ ነው፤ አስቀድሞ የሚተረጉሙት መስኮች ቅርጻቸውን አይቀይሩም ወይም አይጠፉም። አበላሺ ለውጥ ከሆነ በአዲስ የእትም ቅድመ-ቅጥያ (version prefix) ስር ይመጣል፣ ይህም የተጠበቀ እና አሁንም ባዶ ነው። የAPI የለውጥ መዝገብ (changelog) እያንዳንዱን ልቀት ይመዘግባል።

ከእርስዎ አስቀድሞ ከሚጠቀሙት ጋር ይሰራል