added
የ deploy-key ሞዴል፣ bearer token ራሱ project ነው። CLI እና GitHub Action ሁለቱም የሚሠሩት በዚህ ላይ ነው።
api v1 · የአሁኑ
የ API የለውጥ መዝገብ።
ምንም አልተወገደም።
/v1 ሁልጊዜ ነገሮችን ብቻ ያክላል። አዲስ endpoints እና አዲስ የምላሽ መስኮች በተመሳሳይ prefix ውስጥ ይጨመራሉ፣ እና አስቀድሞ የሚተረጉሙት መስኮች ቅርጻቸው አይቀየርም ወይም አይጠፉም። አስፈሪ ለውጥ ከሆነ በአዲስ የእትም prefix ስር ይለቀቃል፣ ይህም ተያይዞ ቀርቶ ባዶ ነው።
v1/api/v1
በአጠቃቀም ላይ ያለው ብቸኛ prefix
በአጠቃቀም ላይ ያለው ብቸኛ prefix
5 እትሞች
11 ለውጦች፣ ምንም አስፈሪ አይደሉም
የመዝገቡ ቅርጽ
አንድ የእትም prefix፣ ምንም አልተወገዱም።
ከእነዚህ አራቱ ውስጥ ሶስቱ የዚህ መዝገብ ባህሪያት ናቸው። አራተኛው API የሚያቀርበው የ webhook ዝርዝር መጠን ነው።
5
በ /v1 ላይ ያሉ እትሞች፣ ሁሉም ተጨማሪ
1
በአጠቃቀም ላይ ያለ የእትም prefix። ቀጣዩ ተያይዞ ቀርቶ ባዶ ነው
0
API ከተለቀቀ በኋላ የተከሰቱ አስፈሪ ለውጦች
12
የተፈረሙ የ webhook ክስተቶች። ምንጭ፡ App\Enums\WebhookEvent
በእትም የተቀነባበረ፣ በ semver አይደለም
ለመጓዝ የቁልፍ ቀስቶችን ይጠቀሙ
2026-07-08
CDN አቅርቦት፣ አጠቃቀም እና የሙከራ ሜዳ (playground)
July 8, 2026 · 4 ለውጦች
05 / 05
added
/v1/incontext/translations፣ /screenshots እና /suggest የሚሉት መንገዶች የእይታ አርታኢውን (visual editor) ያስኬዱ፤ CORS ደግሞ ወደዚህ ቅድመ-ቃል (prefix) ብቻ የተገደበ ነው።
POST /v1/incontext/session የሚለው ጥያቄ የሚለጠፍ ቁልፍ (publishable key) እና Origin በመቀበል ለተወሰነ ክልል የሚሆን የሴሽን ቶከን ይሰጣል።
improved
አሁን በሁለት ቋንቋዎች የሚደረግ ምንጭ ማውጣት (bilingual export)፣ የምንጭ ጽሑፍን በድብቅ ከመተካት ይልቅ ሊመለስ የማይችለውን ዘግቦ ያሳያል። አሁን ያሉት መስኮች አልተቀየሩም፤ ይህ ደግሞ መረጃውን በራስጌ (header) ውስጥ ማስቀመጥ ያለው ዋና ዓላማ ነው።
GET /v1/pull አገልግሎት X-Skipped-Keys እና X-Missing-Source-Keys የሚሉ የምላሽ ራስጌዎችን (response headers) አካትቷል።
added
እንዲሁም /v1/glossary/import፣ /export እና /extract አሉ፤ ይህም የቃላት መዝገቡን ኮንሶሉን (console) ሳይከፍቱ ማስገባት እና ማውጣት ያስችላል።
በ API ላይ ሙሉ የቃላት መዝገብ CRUD አገልግሎት፡ GET፣ POST፣ PUT እና DELETE በ /v1/glossary ላይ።
added
የተገኙት ውጤቶች አስቀድሞ የምትወስዳቸው የትርጉም ረድፎች ላይ ይደርሳሉ፤ ስለዚህ ምንም አዲስ ነገር ለመጠየቅ (poll) አያስፈልግም።
POST /v1/qa/run የሚለው ጥያቄ የጥራት ምርመራን (agentic quality pass) ያስጀምራል እና የምርመራውን መያያዣ (run handle) ይመልሳል።
added
ለእያንዳንዱ መጨረሻ ነጥብ (endpoint) ይመዝገቡ። ዝርዝሩ App\Enums\WebhookEvent ውስጥ ይገኛል፤ አሁን ያሉት ዐሥራ ሁለት አማራጮች ናቸው፤ ይህንን መስመር ከመቁጠር ይልቅ enum ይቁጠሩ።
የተፈረሙ webhooks ቁልፍ፣ ትርጉም፣ ቋንቋ፣ የቃላት መዝገብ እና QA ክስተቶችን ከመጀመሪያው የባች ጥንድ (batch pair) ጋር አብረው ይልካሉ።
improved
ልክኩ ለእያንዳንዱ የተቀየረ ረድፍ አንድ ጥሪ ከማድረግ ይልቅ ብዛት እና እስከ ሃያ ናሙናዎችን ይይዛል። የልክክ መዝገቦች (Delivery logs) እያንዳንዱን ሙከራ ከቀጣዩ የድጋሚ ሙከራ ጊዜ ጋር አብረው ይመዝግባሉ።
translation.updated የሚሉትን የመሳሰሉ ከፍተኛ ድግግሞሽ ያላቸው ክስተቶች በአንድ የጊዜ መስኮት ውስጥ ተጠቃልለው ወደ አንድ ልክክ ይላካሉ፤ ስለዚህ በጅምላ የሚደረግ ማረም (bulk edit) መጨረሻ ነጥቡን አያጨናንቅም።
added
ETag እና አጭር ጊዜ የሚቆይ cache ይመልሳል፤ If-None-Matchንም በ 304 ምላሽ ያከብራል። በ /v{n} ስር ያለው ተለዋዋጭ ያልሆነ ተዛማጅ (immutable sibling) በይዘት አድራሻ (content addressed) የተሰራ ሲሆን ለአንድ ዓመት በ cache ይቀመጣል።
የሕዝብ፣ በ edge cache ሊቀመጥ የሚችል GET /v1/cdn/{project}/{locale} የሚለው አገልግሎት የሚለጠፉትን ጽሑፎችዎን ያቀርባል።
added
በ CI ውስጥ POST /v1/cdn/publish በመጠቀም ያስጀምሩት፤ ንባቦችንም በ X-Transglot-Cdn-Key ራስጌ (header) ውስጥ በተለየ የንባብ ብቻ ቁልፍ ያረጋግጡ። በራስዎ CDN ስር ለማስቀመጥ ደህንነቱ የተጠበቀ ነው።
ማተም (Publishing) አሁን ያሉትን ትርጉሞች ወደ አዲስ ተለዋዋጭ ያልሆነ (immutable) እትም ያሻሽላል፤ ይህም በእጅ ወይም በእያንዳንዱ push ሊከናወን ይችላል።
added
ምንም የጥያቄ አካላት (request bodies) አይቀመጡም። ይህ ቆጠራ ብቻ ነው።
እያንዳንዱ የተረጋገጠ /v1 ጥሪ በቀን ለእያንዳንዱ ቶከን ይቆጠራል፤ ውጤቱም በ deploy hub ላይ ይታያል።
improved
ፕሮጀክት፣ pull፣ ባችዎች እና የቃላት መዝገብ ማውጣት። ለማስኬድ ምንም የጥያቄ ወይም የምላሽ ቅርጽ አልተቀየረም።
Deploy hub የ API ሙከራ ሜዳ (playground) አግኝቷል፤ ይህም የንባብ ብቻ መጨረሻ ነጥቦችን (read-only endpoints) በቀጥታ ከፕሮጀክትዎ ጋር ያስኬዳል።
የማቆም ምዝገባ (deprecation register)
ምንም የለው የሚጠፋ።
አንድ ረድፍ ለእያንዳንዱ የተለቀቀ መድረክ፣ ከመልቀቁ ጋር። የመጨረሻው አምድ የሚታይበት ነው፡ መወገድ ከመከሰቱ በፊት ረጅም ጊዜ ቀን ይኖረዋል።
| መድረክ | ተልቋል | ሁኔታ | የማስወገድ ቀን |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | የአሁን | ምንም አልተያዘም |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | የአሁን | ምንም አልተያዘም |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | የአሁን | ምንም አልተያዘም |
POST /v1/qa/run | June 12, 2026 | የአሁን | ምንም አልተያዘም |
Signed webhook events, twelve typed cases | June 30, 2026 | የአሁን | ምንም አልተያዘም |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | የአሁን | ምንም አልተያዘም |
ከዚህ ጠረጴዛ ላይ ረድፍ አይሰረዝም። መድረኩ ከተገለለ ረድፉን ይይዛል እና ቀን ያገኛል፣ ምክንያቱም ሊታቀድ የሚችል መወገድ አንዱን ማተም ዋናው ዓላማ ነው።
የዛሬው ተስፋ
ሶስት ሕጎች ሊገነቡበት የሚችሉት።
ተጨማሪ
አዲስ መግቢያዎች እና አዲስ የምላሽ መስኮች በ /v1 ውስጥ ይመጡ። አስቀድመው የሚተረጉሙት መስክ ቅርጹ አይቀየርም እና አይጠፋም።
አዲስ ቅጥያ (prefix)
የመሰረት ለውጥ ከዚህ ውስጥ በመግባት ሳይሆን በአዲስ የእትም ቅጥያ (version prefix) ስር ይለቀቅ ነበር። ያ ቅጥያ የተጠበቀ እና ያልተጠቀመ ሲሆን፣ ከዚያ በላይ ያሉ ሁሉም ልቀቶች v1 ላይ ተመስርተዋል።
ግልጽ ራስጌዎች (headers)
አንድ ጥያቄ (pull) አንድን ነገር ሙሉ በሙሉ ማዞር (round-trip) ሲያቅተው፣ ይህንን በራስጌ (header) ውስጥ ያሳውቃል። X-Skipped-Keys እና X-Missing-Source-Keys ከመግለጫውን (body) ከእርስዎ ጋር ሳይቀይሩ ተጨምረዋል።
ተደጋግመው የሚጠየቁ ጥያቄዎች
ገንቢዎች ስለ API እትም እና ጊዜው ማለፍ (deprecation) የሚጠይቋቸው።
Transglot API እትም (versioned) አለው?
አዎ፣ በ URL ቅጥያ (prefix)። እስካሁን ድረስ የተለቀቁት ሁሉ /v1 ስር ይገኙናል፣ ይህም አሁን ባለው ብቸኛ ቅጥያ ነው። የእትም ራስጌ (version header)፣ የቀን መቆለፊያ ወይም ማስተካከያ የሚጠይቅ ምንም ነገር የለም።
ማዘመን የእኔን ኢንተግሬሽን ሊያበላሽ ይችላል?
በ/v1 ውስጥ አይደለም። አዲስ መግቢያዎች (endpoints) እና አዲስ የምላሽ መስኮች ይጨመራሉ፣ ነገር ግን አስቀድመው የሚተረጉሙት መስክ ቅርጹ አይቀየርም እና አይጠፋም። ለውጡ በተጨማሪነት (additively) ሊደረግ ካልቻለ በአዲስ ቅጥያ ስር ይሄዳል፣ እና አሮጌው እንደተለመደው ይሰራል።
ምንም ነገር ጊዜው አልፎበት (deprecated) ወይም ተወግዷል?
ምንም፣ እና ከላይ ያለው መዝገብ ይህንን በየረድፉ ያረጋግጣል። የተለቀቁት ሁሉም ገጽታዎች ከተለቀቁበት ልቀት ጋር ተዘርዝረዋል፣ የማስወገድ አምድም እስከታች ድረስ "ምንም አልተያዘም" ብሎ ያነባል።
ማስወገድ ምን ያህል ማስጠንቀቂያ ይሰጣል?
ማስወገድ ከመከሰቱ በፊት ረጅም ጊዜ በፊት ቀን ተያይዞ በዚያ መዝገብ ላይ ይታያል፣ እና ረድፉ ከጠፋ ይልቅ ከዚያ በኋላም በሰንጠረዡ ላይ ይቆያል። ሊታቀድበት የሚችል ቀን መኖሩ አንዱን ማተም ዋና ዓላማው ነው።
አዲስ ነገር ሲለቀቅ እንዴት ማወቅ እችላለሁ?
እያንዳንዱ ልቀት በዚህ ገጽ ላይ ቀን አለው። የምርት ለውጥ መዝገብ (changelog) የሚለቀቁትን ሌሎች ነገሮች ሁሉ ይሸፍናል፣ እና ኮንሶሉ ላይ ያላነበቡት ነገር ሲኖር አመላካች ያሳያል።
ለምን ለ API የተለየ የለውጥ መዝገት አለ?
ምክንያቱም API የምርት ልቀት የማይሸከመውን የተጓዳኝነት ቃል ኪዳን ይዟል። አንድ አቀናባሪ (integration) አሁንም እየሰራ መሆኑን ለማረጋገጥ የሚፈልግ አበል (developer) የአዲስ ባህሪ ስራዎችን በማሻቀብ ሳይሆን መረጃውን ማግኘት አለበት።
APIን ወደ እቅዴ እንዴት ማካተት እችላለሁ?
Bearer token በ Starter እቅድ በወር $19 ይጀምራል። Free እቅድ ኮንሶሉን ይሸፍናል ነገር ግን token ማመንጨት አይችልም፤ CLI፣ GitHub Action፣ webhooks እና MCP ሁሉም ከዚሁ token ጀርባ ይገኙ።
የ endpoints ማጣቀሻ (reference) የት ነው?
በ API ገጹ ላይ፡ ማጽናት (authentication)፣ endpoints፣ የፍጥነት ገደብ (rate limit)፣ የፋይል ቅርጸቶች እና የ webhook ዝርዝር። ይህ ገጽ የተቀየሩት ነገሮች እና መቼ እንደተቀየሩ ብቻ የሚያሳይ መዝገብ ነው።
ከእርስዎ አስቀድሞ ከሚጠቀሙት ጋር ይሰራል
41 አገናኞች፣ አስቀድሞ የተገነቡ።
ውሉ ምርቱ ነው
በ API ላይ ይገንቡ የማይንቀሳቀስ።
API በ Starter እና ከዚያ በላይ ያሉ እቅዶች ላይ ይገኛል። Free እቅድ $0 ሲሆን ለመጀመር 100,000 ቃላትን ይሰጣል (በምዝገባ ጊዜ 25,000፣ ከስልክ ማረጋገጫ በኋላ 75,000)፣ ከዚያ በኋላ በወር 10,000፣ እና API ወይም webhooks የሉም።