added
डिप्लॉय-की मॉडल, जहाँ बेयरर टोकन ही प्रोजेक्ट है। यह वही है जिस पर सीएलआई और गिटहब एक्शन दोनों चलते हैं।
एपीआई v1 · वर्तमान
एपीआई चेंजलॉग।
कुछ भी हटाया नहीं गया।
/v1 में केवल नई चीज़ें जुड़ती हैं। नए एंडपॉइंट और नए रिस्पॉन्स फ़ील्ड उसी प्रीफ़िक्स के अंदर आते हैं, और कोई भी फ़ील्ड जिसका आप पहले से पार्स कर रहे हैं, कभी अपनी संरचना नहीं बदलता या गायब नहीं होता। ब्रेकिंग चेंज एक नए वर्शन प्रीफ़िक्स के तहत आएगा, जो आरक्षित है और अभी खाली है।
v1/api/v1
उपयोग में एकमात्र प्रीफ़िक्स
उपयोग में एकमात्र प्रीफ़िक्स
5 रिलीज़
11 बदलाव, जिनमें से कोई भी ब्रेकिंग नहीं है
लॉग की संरचना
एक वर्शन प्रीफ़िक्स, कोई हटाया नहीं गया।
इनमें से तीन इस लॉग के अपने गुण हैं। चौथा वह वेबहुक कैटलॉग का आकार है जिसे एपीआई सर्व करता है।
5
/v1 पर रिलीज़, हर एक एडिटिव
1
उपयोग में वर्शन प्रीफ़िक्स। अगला आरक्षित और खाली है
0
एपीआई लॉन्च होने के बाद से ब्रेकिंग चेंज
12
साइन किए गए वेबहुक इवेंट। स्रोत: App\Enums\WebhookEvent
सेमवर के बजाय रिलीज़ के अनुसार दिनांकित
यात्रा करने के लिए एरो कीज़ का उपयोग करें
2026-07-08
CDN डिलीवरी, उपयोग और प्लेग्राउंड
July 8, 2026 · 4 बदलाव
05 / 05
added
/v1/incontext/translations, /screenshots और /suggest विज़ुअल एडिटर को चलाते हैं, जहाँ CORS उसी प्रीफ़िक्स तक सीमित है और कुछ और नहीं।
POST /v1/incontext/session एक पब्लिशेबल की और Origin का आदान-प्रदान करके एक स्कोप्ड सेशन टोकन देता है।
improved
बायलिंगुअल एक्सपोर्ट अब साइलेंटली सोर्स टेक्स्ट को सब्सीट्यूट करने के बजाय यह रिपोर्ट करता है कि इसे क्या राउंड-ट्रिप नहीं किया जा सका। मौजूदा फ़ील्ड अपरिवर्तित रहते हैं, जो हेडर में इसे रखने का मुख्य उद्देश्य है।
GET /v1/pull में अब X-Skipped-Keys और X-Missing-Source-Keys रिस्पॉन्स हेडर शामिल हैं।
added
साथ ही /v1/glossary/import, /export और /extract, ताकि कंसोल खोले बिना टर्म बेस को अंदर और बाहर ले जाया जा सके।
API पर पूर्ण टर्म-बेस CRUD: /v1/glossary पर GET, POST, PUT और DELETE।
added
निष्कर्ष उन अनुवाद पंक्तियों पर आते हैं जिन्हें आप पहले ही पुल करते हैं, इसलिए किसी नई चीज़ को पोल करने की आवश्यकता नहीं होती।
POST /v1/qa/run एक एजेंटिक क्वालिटी पास को ट्रिगर करता है और रन हैंडल लौटाता है।
added
प्रति एंडपॉइंट सब्सक्राइब करें। सूची स्वयं App\Enums\WebhookEvent में रहती है, जिसमें आज बारह केसेस हैं; इस लाइन के बजाय एनम की गिनती करें।
साइन किए गए वेबहुक मूल बैच पेयर के साथ-साथ की, अनुवाद, भाषा, ग्लोसरी और QA इवेंट्स उत्सर्जित करते हैं।
improved
डिलीवरी में बदली हुई हर पंक्ति के लिए एक कॉल के बजाय एक काउंट और अधिकतम बीस सैंपल होते हैं। डिलीवरी लॉग अगले रिट्राई के समय के साथ हर प्रयास को रिकॉर्ड करते हैं।
translation.updated जैसे हाई-फ़्रीक्वेंसी इवेंट्स एक विंडो में एक डिलीवरी में समेकित हो जाते हैं, इसलिए बल्क एडिट कभी भी एंडपॉइंट को ओवरलोड नहीं करता।
added
यह एक ETag और शॉर्ट-लिव्ड कैश लौटाता है और If-None-Match का सम्मान 304 के साथ करता है। /v{n} के तहत इम्यूटेबल सिबलिंग कंटेंट-एड्रेस्ड है और एक वर्ष के लिए कैश्ड है।
एक पब्लिक, एज-कैशेबल GET /v1/cdn/{project}/{locale} आपके पब्लिश किए गए स्ट्रिंग्स को सर्व करता है।
added
CI में POST /v1/cdn/publish के साथ इसे ट्रिगर करें, और X-Transglot-Cdn-Key हेडर में एक डेडिकेटेड रीड-ओनली की के साथ रीड्स को ऑथराइज़ करें। अपने स्वयं के CDN के पीछे रखने के लिए सुरक्षित।
प्रकाशन वर्तमान अनुवादों को मैन्युअल रूप से या हर पुश पर एक नए इम्यूटेबल वर्जन में प्रमोट करता है।
added
कोई रिक्वेस्ट बॉडी स्टोर नहीं की जाती है। यह केवल एक गिनती है और कुछ नहीं।
प्रत्यधिकृत /v1 कॉल की गिनती प्रति टोकन प्रति दिन की जाती है, और डिप्लॉय हब पर दिखाई जाती है।
improved
प्रोजेक्ट, पुल, बैचेस और ग्लोसरी एक्सपोर्ट। इसे काम करने के लिए कोई रिक्वेस्ट या रिस्पॉन्स शेप बदला नहीं गया।
डिप्लॉय हब ने एक API प्लेग्राउंड प्राप्त किया जो आपके प्रोजेक्ट के खिलाफ लाइव रीड-ओनली एंडपॉइंट्स चलाता है।
डिप्रिकेशन रजिस्टर
कुछ भी हटाया नहीं जा रहा है।
प्रत्येक पब्लिश किए गए सर्फेस के लिए एक पंक्ति, जिसमें वह रिलीज़ शामिल है जिसने इसे शिप किया था। अंतिम कॉलम वह है जिस पर नज़र रखनी है: हटाने की स्थिति में, यह होने से बहुत पहले वहाँ एक तारीख के साथ दिखाई देगा।
| सर्फेस | शिप किया गया | स्थिति | हटाने की तारीख |
|---|---|---|---|
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 के भीतर जारी किए जाते हैं। वह फ़ील्ड जिसका आप पहले से पार्सिंग कर रहे हैं, उसका स्वरूप नहीं बदलता और वह गायब नहीं होता।
नया प्रीफ़िक्स
ब्रेकिंग चेंज इस वर्जन के बजाय एक नए वर्जन प्रीफ़िक्स के तहत जारी किया जाएगा। वह प्रीफ़िक्स आरक्षित और अप्रयुक्त है, और v1 के ऊपर हर रिलीज़ उसी पर आधारित है।
पारदर्शी हेडर्स
जब एक पुल कुछ राउंड-ट्रिप नहीं कर पाता, तो यह हेडर में बता देता है। आपके नीचे बॉडी को बदलने के बजाय X-Skipped-Keys और X-Missing-Source-Keys जोड़े गए थे।
अक्सर पूछे जाने वाले प्रश्न
डेवलपर API वर्जनिंग और डिप्रिकेशन के बारे में क्या पूछते हैं।
क्या Transglot API वर्जन्ड है?
हाँ, URL प्रीफ़िक्स द्वारा। अब तक प्रकाशित सब कुछ /v1 के तहत है, जो कि एकमात्र उपयोग में प्रीफ़िक्स है। कोई वर्जन हेडर नहीं, कोई डेट पिन नहीं और कॉन्फ़िगर करने के लिए कुछ भी नहीं है।
क्या कोई अपडेट मेरे इंटीग्रेशन को कभी ब्रेक करेगा?
/v1 के भीतर नहीं। नए एंडपॉइंट और नए रिस्पॉन्स फ़ील्ड जोड़े जाते हैं, लेकिन वह फ़ील्ड जिसका आप पहले से पार्सिंग कर रहे हैं, उसका स्वरूप नहीं बदलता और वह गायब नहीं होता। यदि कोई चेंज योगात्मक रूप से नहीं किया जा सकता, तो उसे एक नए प्रीफ़िक्स के तहत डाला जाता है, और पुराना वाला काम करता रहता है।
क्या कोई चीज़ डिप्रिकेट या हटाई गई है?
कुछ नहीं, और ऊपर दिया गया रजिस्टर पंक्ति-दर-पंक्ति यही कहता है। प्रत्येक प्रकाशित सर्फ़ेस को उस रिलीज़ के साथ सूचीबद्ध किया गया है जिसने इसे शिप किया था, और एक रिमूवल कॉलम है जिसमें अभी सभी जगह "कोई निर्धारित नहीं" लिखा है।
किसी हटाने के लिए कितना नोटिस दिया जाएगा?
हटाने से बहुत पहले उस रजिस्टर में एक तारीख के साथ दिखाई देगा, और बाद में वह पंक्ति गायब होने के बजाय टेबल में बनी रहेगी। योजना बनाने योग्य तारीख ही इसे प्रकाशित करने का पूरा उद्देश्य है।
मुझे कैसे पता चलेगा कि कब कुछ नया शिप हुआ?
इस पेज पर हर रिलीज़ की तारीख दर्ज होती है। प्रोडक्ट चेंजलॉग बाकी सभी शिप हुई चीज़ों को कवर करता है, और कंसोल में एक मार्कर दिखाता है जब आपके द्वारा न पढ़ी गई कोई चीज़ होती है।
API के लिए अलग चेंजलॉग क्यों है?
क्योंकि API एक कम्पैटिबिलिटी वादा रखता है जो प्रोडक्ट रिलीज़ नहीं रखती। एक डेवलपर जो यह जाँच रहा है कि इंटीग्रेशन अभी भी काम कर रहा है, उसे पता लगाने के लिए फ़ीचर वर्क के बीच स्क्रॉल नहीं करना चाहिए।
मैं अपनी प्लान में API कैसे जोड़ूं?
एक बेयरर टोकन स्टार्टर प्लान पर $19 प्रति माह से शुरू होता है। फ्री प्लान कंसोल को कवर करता है लेकिन टोकन नहीं बना सकता, और CLI, GitHub Action, वेबहुक और MCP सभी उसी टोकन के पीछे हैं।
एंडपॉइंट्स के लिए रेफ़रेंस कहाँ है?
API पेज पर: प्रमाणीकरण, एंडपॉइंट्स, रेट लिमिट, फ़ाइल फ़ॉर्मैट और वेबहुक कैटलॉग। यह पेज केवल इसका रिकॉर्ड है कि क्या बदला और कब।
उन टूल्स के साथ काम करता है जिनका आप पहले से उपयोग कर रहे हैं
41 कनेक्टर, पहले से निर्मित।
कॉन्ट्रैक्ट ही प्रोडक्ट है
एक API पर बनाएं जो स्थिर रहता है।
API स्टार्टर और उससे ऊपर के प्लान पर उपलब्ध है। फ्री प्लान $0 है, जिसमें शुरू करने के लिए 100,000 शब्द शामिल हैं (साइन-अप पर 25,000, फोन चेक के बाद 75,000), उसके बाद महीने में 10,000, और कोई API या वेबहुक नहीं।