api.transglot.ai/v1bearer token, एक प्रोजेक्टरेफ़रंस

एक फ़ाइल पुश करें। हर भाषा वापस पाएँ।

आपके ऐप का अनुवाद करने के लिए एक REST API। एक POST सोर्स फ़ाइल अपलोड करता है, एक GET एक तैयार लोकल वापस लाता है, और bearer token ही पूरी ऑथेंटिकेशन है। 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

स्टार्टर पर माहाना शब्द, पहला प्लान जो टोकन बना सकता है।

मुफ़्त में शुरू करें डेवलपर सरफ़ेस देखें

प्रति टोकन प्रति मिनट 60 अनुरोध · हर 429 में Retry-After होता है · CI और प्रोडक्शन के लिए अलग-अलग टोकन दें

कंसोल एक API क्लाइंट है

पुश, अनुवाद, गेट और पुल, प्रत्येक एक REST एंडपॉइंट है।

नीचे दी गई तस्वीर की प्रत्येक पंक्ति के पीछे एक राउट है: पुश, गेट्स, शब्दावली, बैच और पुल, जो सभी आपके अपने कोड से प्रोजेक्ट टोकन के साथ पहुँच योग्य हैं। कंसोल में API प्लेग्राउंड रीड-ओनली वाले को आपके प्रोजेक्ट पर लाइव चलाता है, ताकि आप पहले वास्तविक प्रतिक्रिया देख सकें।

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

आप एक सोर्स फ़ाइल अपलोड करते हैं
POST/v1/push
गेट्स पैनल भर जाता है
POST/v1/qa/run
आप किसी शब्द को लॉक करते हैं
POST/v1/glossary
बैच व्यू स्वयं को पोल करता है
GET/v1/batches/:id
आप अनुवादों को वापस लेते हैं
GET/v1/pull

प्रति पैनल एक राउट, प्रति मिनट 60, टोकन के आधार पर क्षमताएँ · अपने अनुवादों को बाहर निकालना भी एक एंडपॉइंट है

यह सिर्फ़ HTTP है

चार चीज़ें जो टीमें सबसे पहले बनाती हैं।

प्रत्येक एक सिंगल एंडपॉइंट और एक प्रोजेक्ट टोकन है · इनमें से किसी को भी एक दोपहर नहीं लगती

मर्ज गेट · एक वर्कफ़्लो फ़ाइल

जब अनुवाद विफल हो तो पुल रिक्वेस्ट को लाल करें।

क्रॉन · रात भर

हर रात रिलीज़ नोट्स का अनुवाद करें।

बॉट · एक सब्सक्रिप्शन

जैसे ही कोई बैच पूरा हो, Slack पर पोस्ट करें।

एजेंट · MCP

एआई एजेंट को वही 17 टूल दें जो आपके पास हैं।

प्रति मिनट अनुरोध

प्रति अकाउंट नहीं, बल्कि प्रति टोकन, हर 429 पर Retry-After हेडर के साथ यह बताते हुए कि कितने सेकंड इंतज़ार करना है।

फ़ाइल फ़ॉर्मेट

उस फ़ॉर्मेट को पुश और पुल करें जो आपके रिपॉज़िटरी में पहले से उपयोग किया जा रहा है। बहुवचन और प्लेसहोल्डर दोनों दिशाओं में सुरक्षित रहते हैं। इसे किसी भी कॉल पर format= के साथ नाम दें।

वेबहुक इवेंट

पूरा कैटलॉग, प्रत्येक के साथ एक उदाहरण पेलेड है जो वास्तविक डिलीवरी के सटीक आकार में होता है। GET /v1/webhooks/events।

MCP टूल

वही प्रोजेक्ट टोकन, जिसे curl के बजाय एजेंट रनटाइम को दिया जाता है। npx -y @transglot/mcp।

अक्सर पूछे जाने वाले प्रश्न

पहले अनुरोध से पहले डेवलपर्स क्या पूछते हैं।

मैं Transglot API के साथ प्रमाणीकरण कैसे करूँ?

एक बेयरर टोकन भेजें: Authorization: Bearer $TRANSGLOT_TOKEN. टोकन एक प्रोजेक्ट से संबंधित होता है, इसलिए पथ में कोई प्रोजेक्ट आईडी नहीं होती और कोई खाता-स्तरीय कुंजी लीक नहीं होती। आप प्रोजेक्ट पेज पर टोकन बनाते हैं और प्रत्येक टोकन अपनी क्षमताएं रखता है: पुश, पुल, प्रबंधन, रीड, राइट।

क्या API मुफ़्त है?

नहीं। बेयरर टोकन स्टार्टर प्लान पर $19 प्रति माह से शुरू होता है। मुफ़्त संस्करण कंसोल को कवर करता है, जो यह देखने के लिए पर्याप्त है कि उत्पाद आपके अनुकूल है या नहीं, लेकिन यह टोकन नहीं बना सकता। CLI, GitHub Action, वेबहुक, MCP और डिलीवरी बंडल सभी उसी टोकन के पीछे होते हैं, इसलिए वे एक साथ उपलब्ध होते हैं।

मैं Transglot में स्ट्रिंग्स कैसे अपलोड करूँ?

POST /v1/push फ़ाइल और उसके फ़ॉर्मेट के साथ, उदाहरण के लिए -F "file=@lang/en.json" -F "format=laravel_json". यह 202 उत्तर देता है और एक बैच को कतार में लगाता है। केवल वे पंक्तियाँ अनुवादित की जाती हैं जो वास्तव में बदली गई हैं, इसलिए अपरिवर्तित फ़ाइल पुश करने का कोई खर्च नहीं होता।

मैं अपने अनुवादों को वापस कैसे प्राप्त करूँ?

GET /v1/pull, किसी भी 20 फ़ॉर्मेट में, जब भी आप चाहें। यह वह एंडपॉइंट है जिसे CLI रैप करता है, और जिस पर API प्लेग्राउंड लाइव चलता है। डेटा निर्यात करने के लिए कोई अनुरोध फ़ाइल नहीं है और न ही कोई ऐसी अवधि है जिसमें डेटा आपका होना बंद हो जाए।

API की दर सीमा क्या है?

प्रति मिनट 60 अनुरोध, खाते के बजाय प्रति टोकन गिने जाते हैं। इससे अधिक होने पर आपको एक Retry-After हेडर वाला 429 मिलता है जो बताता है कि कितने सेकंड इंतज़ार करना है, और कुछ भी चार्ज नहीं होता या आधा लिखा जाता है। CI और प्रोडक्शन के लिए अलग-अलग टोकन दें ताकि शोरगुल वाली बिल्ड आपके ऐप को भूखा न रख सके।

Which languages does the API support?

There is no fixed list. The validator accepts any BCP-47 tag ICU recognises, which is 708 locales in the table it checks against, plus a structural fallback for tags outside it. Add a locale to the project and the next push includes it.

मैं किन फ़ाइल फ़ॉर्मेट को पुश और पुल कर सकता हूँ?

बीस: JSON फ्लैट और नेस्टेड, 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। इनमें से सात बहुवचन ले जाते हैं, और फ़ाइल उसी रूप में वापस आती है जिसमें गई थी।

क्या Transglot में वेबहुक हैं?

हाँ। 12 वेबहुक ईवेंट हैं, जिनमें batch.completed, translation.reviewed, qa.completed और source_drift.repaired शामिल हैं। प्रत्येक डिलीवरी एक टाइमस्टैम्प हेडर के साथ HMAC साइन की जाती है ताकि आप इसे सत्यापित कर सकें, और GET /v1/webhooks/events प्रत्येक के लिए एक नमूना पेलोड के साथ कैटलॉग लौटाता है।

क्या AI एजेंट्स के लिए कोई MCP सर्वर है?

हाँ। npx -y @transglot/mcp आपके प्रोजेक्ट टोकन पर 17 टूल उपलब्ध कराता है, ताकि कोई असिस्टेंट अनुवाद पढ़ सके, लिख सके, भाषा जोड़ सके, रन शुरू कर सके, बैच की जाँच कर सके या शब्दावली संपादित कर सके। यह वही API और वही अनुमतियाँ हैं, जिन्हें कर्ल के बजाय एजेंट रनटाइम से एक्सेस किया जाता है।

क्या मैं इसे CI में चला सकता हूँ?

हाँ। GitHub Action (transglot/transglot-action@v1) और CLI दोनों इन एंडपॉइंट्स को रैप करते हैं। जब किसी पंक्ति को अस्वीकार किया जाता है, तो transglot push --wait एग्ज़िट कोड 4 के साथ समाप्त होता है और Action उस रन पर अपने जॉब को विफल घोषित करता है। मर्ज रोकने के लिए, इसे पुल रिक्वेस्ट पर चलाएँ जिसमें इसका कमिट इनपुट none पर सेट हो, एक स्टेप जोड़ें जो तब विफल हो जब खींची गई फ़ाइल में कोई कुंजी गायब हो, और जॉब को शाखा सुरक्षा में आवश्यक चेक बनाएँ।

जब एक अनुवाद गुणवत्ता जाँच में विफल हो जाता है तो क्या होता है?

चार निर्धारक गेट हर पंक्ति को पढ़ते हैं: प्लेसहोल्डर, बहुवचन, शब्दावली शब्द और लंबाई। एक टूटा प्लेसहोल्डर, गायब बहुवचन रूप या प्रतिबंधित शब्दावली शब्द मिलने पर एक स्वचालित सुधारात्मक पुनः प्रयास होता है, और यदि यह फिर भी विफल रहता है तो पंक्ति को लिखने के बजाय अस्वीकार कर दिया जाता है। वह पंक्ति जिसकी लंबाई केवल अधिक हो जाती है, उसे लिख दिया जाता है, अस्वीकार नहीं किया जाता। GET /v1/batches/:id?include=failures अस्वीकृत पंक्तियों और उनके कारणों की सूची देता है।

क्या API कभी मेरे इंटीग्रेशन को तोड़ेगा?

नहीं। /v1 केवल एंडपॉइंट और प्रतिक्रिया फ़ील्ड जोड़ता है; एक फ़ील्ड जिसे आप पहले से पार्स कर रहे हैं, अपना आकार नहीं बदलता या गायब नहीं होता। एक ब्रेकिंग परिवर्तन एक नए वर्जन प्रीफ़िक्स के तहत शिप होगा, जो आरक्षित है और अभी खाली है। API चेंजलॉग हर रिलीज़ को रिकॉर्ड करता है।

उन टूल्स के साथ काम करता है जिनका आप पहले से उपयोग कर रहे हैं