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

स्टार्टरवर महिन्याला शब्द, token तयार करू शकणारा पहिला प्लॅन.

मोफत सुरू करा डेव्हलपर पृष्ठ पहा

प्रति token दर मिनिटाला ६० रिक्वेस्ट्स · प्रत्येक ४२९ मध्ये Retry-After असतो · CI आणि प्रॉडक्शनसाठी वेगळे tokens द्या

कन्सोल ही api क्लायंट आहे

पुश, अनुवाद, गेट आणि पुल, प्रत्येक एक REST एंडपॉईंट.

खालील चित्रातील प्रत्येक ओळीमागे एक राऊट आहे: पुश, गेट्स, शब्दावली, बॅचेस आणि पुल, सर्व तुमच्या स्वतःच्या कोडमधून प्रकल्प token सह पोहोचता येतात. कन्सोलमधील API प्लेग्राउंड वाचन-फक्त (read-only) लाईव्ह तुमच्या प्रकल्पावर चालवते, ज्यामुळे तुम्हाला प्रथम वास्तविक प्रतिसाद दिसतो.

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

प्रत्येक पॅनेलसाठी एक रूट, मिनिटाला ६०, टोकननुसार क्षमता · आपले अनुवाद बाहेर पाठवणे हे देखील एक एंडपॉइंट आहे

ते फक्त HTTP आहे

संघ सर्वात आधी बनवतात त्या चार गोष्टी.

प्रत्येक एक हा सिंगल एंडपॉइंट आणि प्रोजेक्ट टोकन आहे · कोणत्याही गोष्टीला अर्धा दिवस लागत नाही

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

अनुवाद अयशस्वी झाल्यास पुल रिक्वेस्ट लाल करा.

क्रॉन · रात्री

दररोज रात्री रिलीझ नोट्सचे अनुवाद करा.

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

बॅच पूर्ण होताच Slack वर पोस्ट करा.

एजंट · MCP

एआय एजंटला तुमच्याकडे असलेली तीच १७ टूल्स द्या.

मिनिटाला विनंत्या

प्रत्येक खात्याऐवजी प्रति टोकन, प्रत्येक ४२९ वर Retry-After हेडरसह किती सेकंद वाट पहायची हे सांगते.

फाइल फॉरमॅट्स

तुमच्या रिपॉझिटरीमध्ये आधीपासून वापरले जाणारे फॉरमॅट पुश आणि पुल करा. बहुवचन आणि प्लेसहोल्डर्स दोन्ही दिशांना जिवंत राहतात. कोणत्याही कॉलवर format= सह नाव द्या.

वेबहुक इव्हेंट्स

संपूर्ण कॅटलॉग, प्रत्येकास खऱ्या डिलिव्हरीच्या अचूक स्वरूपात उदाहरण पेलोडसह. GET /v1/webhooks/events.

MCP टूल्स

तोच प्रोजेक्ट टोकन, curl ऐवजी एजंट रनटाइमला दिला जातो. npx -y @transglot/mcp.

FAQs

पहिल्या विनंतीपूर्वी डेव्हलपर्स काय विचारतात.

मी Transglot API सह कसे ऑथेंटिकेट करू?

बेअरर टोकन पाठवा: Authorization: Bearer $TRANSGLOT_TOKEN. टोकन एका प्रोजेक्टशी संबंधित असते, म्हणून पाथमध्ये प्रोजेक्ट आयडी नसतो आणि लीक होण्यासाठी खाते-स्तरीय की नसते. तुम्ही टोकन्स प्रोजेक्ट पृष्ठावर तयार करता आणि प्रत्येकाची स्वतःची क्षमता असते: पुश, पुल, व्यवस्थापन, वाचन, लेखन.

API मोफत आहे का?

नाही. बेअरर टोकन स्टार्टर प्लानवर महिन्याला $१९ पासून सुरू होते. मोफत आवृत्ती कन्सोल कव्हर करते, जी उत्पादन योग्य आहे की नाही हे पाहण्यासाठी पुरेशी आहे, परंतु ती टोकन तयार करू शकत नाही. CLI, GitHub Action, वेबहुक्स, MCP आणि डिलिव्हरी बंडल हे सर्व त्याच टोकनमागे आहेत, म्हणून ते एकत्र येतात.

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

फाइल आणि त्याचे फॉरमॅटसह POST /v1/push, उदाहरणार्थ -F "file=@lang/en.json" -F "format=laravel_json". ते २०२ उत्तर देते आणि बॅच रांगेत ठेवते. केवळ बदललेल्या ओळींचे अनुवाद केले जातात, म्हणून अपरिवर्तित फाइल पुश करण्याचा कोणताही खर्च होत नाही.

मी माझे अनुवाद परत कसे मिळवू?

जेव्हा हवे तेव्हा २० फॉरमॅट्सपैकी कोणत्याही फॉरमॅटमध्ये GET /v1/pull. हे CLI रॅप करते तो एंडपॉइंट आहे आणि API प्लेग्राउंड लाईव्ह चालवते. फाइल करण्यासाठी कोणतीही एक्सपोर्ट विनंती नाही आणि डेटा तुमचा थांबण्याची कोणतीही विंडो नाही.

API रेट लिमिट काय आहे?

प्रति मिनिट ६० विनंत्या, ज्या खात्याऐवजी टोकननुसार मोजल्या जातात. यापेक्षा जास्त झाल्यास तुम्हाला Retry-After हेडरसह ४२९ त्रुटी मिळते, ज्यामध्ये किती सेकंद वाट पाहावी हे सांगितले जाते, आणि कोणताही शुल्क आकारला जात नाही किंवा अर्धवट लेखन होत नाही. CI आणि प्रॉडक्शनसाठी वेगवेगळी टोकने द्या, जेणेकरून गोंगाट करणारी बिल्ड तुमच्या ऍपला उपाशी ठेवू शकणार नाही.

API कोणत्या भाषांना समर्थन देतो?

कोणतीही निश्चित यादी नाही. व्हॅलिडेटर ICU ने ओळखलेला कोणताही BCP-47 टॅग स्वीकारतो, जो त्याच्या तपासणी टेबलमधील ७०८ लोकेल्स आहेत, तसेच त्याबाहेरील टॅग्जसाठी स्ट्रक्चरल फॉलबॅक आहे. प्रकल्पात एक लोकेल जोडा आणि पुढील पुशमध्ये ते समाविष्ट होईल.

मी कोणत्या फाइल फॉरमॅट्स पुश आणि पुल करू शकतो?

वीस: 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 कडे वेबहुक्स आहेत का?

होय. १२ वेबहुक इव्हेंट्स आहेत, ज्यामध्ये batch.completed, translation.reviewed, qa.completed आणि source_drift.repaired समाविष्ट आहेत. प्रत्येक डिलिव्हरी HMAC सह स्वाक्षरी केलेली असते आणि टाइमस्टॅम्प हेडर असतो, ज्यामुळे तुम्ही ती पडताळू शकता, आणि GET /v1/webhooks/events प्रत्येकासाठी सॅम्पल पेलोडसह कॅटलॉग परत करते.

AI एजंट्ससाठी MCP सर्व्हर आहे का?

हो. npx -y @transglot/mcp तुमच्या प्रोजेक्ट टोकनद्वारे १७ टूल्स उपलब्ध करते, ज्यामुळे सहाय्यक अनुवाद वाचू शकतो, लिहू शकतो, भाषा जोडू शकतो, रन सुरू करू शकतो, बॅच तपासू शकतो किंवा शब्दावली संपादित करू शकतो. हे तेच API आणि तेच परवानगे आहेत, जे curl ऐवजी एजंट रनटाइममधून प्राप्त केले जातात.

मी हे CI मध्ये चालवू शकतो का?

हो. GitHub Action (transglot/transglot-action@v1) आणि CLI दोन्ही या एंडपॉइंट्सना रॅप करतात. जेव्हा एखादी ओळ नाकारली जाते, तेव्हा transglot push --wait 4 सह बाहेर पडते आणि Action त्या रनवरील जॉब फेल करते. मर्ज थांबवण्यासाठी, त्याला पुल रिक्वेस्टवर चालवा जिथे त्याचे कमिट इनपुट 'none' सेट केले आहे, अशी स्टेप जोडा की जर पुल केलेल्या फाइलमध्ये की गहाळ असेल तर ती फेल होईल, आणि ब्रांच प्रोटेक्शनमध्ये जॉबला आवश्यक चेक बनवा.

जेव्हा भाषांतर गुणवत्ता तपासणीत अपयशी ठरते तेव्हा काय होते?

चार निश्चित गेट्स प्रत्येक ओळ वाचतात: प्लेसहोल्डर्स, बहुवचने, शब्दावलीतील संज्ञा आणि लांबी. चुकीचा प्लेसहोल्डर, गहाळ बहुवचन रूप किंवा प्रतिबंधित शब्दावली संज्ञा आढळल्यास एक स्वयंचलित सुधारणा पुनःप्रयत्न केला जातो, आणि तरीही अपयश आल्यास ओळ लिहिण्याऐवजी नाकारली जाते. केवळ लांबीची मर्यादा ओलांडणारी ओळ नाकारली जात नाही, तर लिहिली जाते. GET /v1/batches/:id?include=failures नाकारलेल्या ओळी आणि त्यांची कारणे सूचीबद्ध करते.

API माझ्या इंटिग्रेशनला कधी ब्रेक करेल का?

नाही. /v1 मध्ये फक्त एंडपॉइंट्स आणि रिस्पॉन्स फिल्ड्सची भर पडते; तुम्ही आधीच पार्स केलेली फील्ड बदलत नाही किंवा गायब होत नाही. ब्रेकिंग चेंज नवीन व्हर्जन प्रीफिक्सखाली येईल, जी राखीव आहे आणि अद्याप रिकामी आहे. API चेंजलॉगमध्ये प्रत्येक रिलीझ नोंदवले जाते.

तुम्ही आधीपासून चालवत असलेल्या गोष्टींसह कार्य करते