فائل اپ لوڈ کریں۔ تمام زبانیں واپس حاصل کریں۔

بیئرر ٹوکن بھیجیں: Authorization: Bearer $TRANSGLOT_TOKEN۔ ٹوکن ایک پروجیکٹ سے وابستہ ہوتا ہے، اس لیے راستے میں پروجیکٹ آئی ڈی نہیں ہوتی اور نہ ہی اکاؤنٹ وائیڈ کلید لیک ہوتی ہے۔ آپ پروجیکٹ پیج پر ٹوکن بناتے ہیں اور ہر ایک کی اپنی صلاحیتیں ہوتی ہیں: پش، پل، مینیج، پڑھنا، لکھنا۔

نہیں۔ بیئرر ٹوکن سٹارٹر پلان پر ماہانہ $19 سے شروع ہوتا ہے۔ مفت کنسول کا احاطہ کرتا ہے، جو یہ دیکھنے کے لیے کافی ہے کہ آیا پروڈکٹ موزوں ہے یا نہیں، لیکن یہ ٹوکن نہیں بنا سکتا۔ CLI، GitHub Action، ویب ہکس، MCP اور ڈیلیوری بنڈل سب اسی ٹوکن کے پیچھے ہوتے ہیں، اس لیے وہ ایک ساتھ آتے ہیں۔

فائل اور اس کے فارمیٹ کے ساتھ POST /v1/push کریں، مثلاً -F "file=@lang/en.json" -F "format=laravel_json"۔ یہ 202 کا جواب دیتا ہے اور بیچ کو قطار میں لگا دیتا ہے۔ صرف وہ قطاریں ترجمہ کی جاتی ہیں جو واقعی تبدیل ہوئی ہیں، اس لیے غیر تبدیل شدہ فائل پش کرنے کی کوئی قیمت نہیں ہوتی۔

GET /v1/pull، 20 فارمیٹس میں سے کسی میں بھی، جب چاہیں۔ یہ وہی اینڈ پوائنٹ ہے جسے CLI لپیٹتا ہے، اور وہی جسے API پلے گراؤنڈ براہ راست چلاتا ہے۔ ڈیٹا نکالنے کی کوئی درخواست فائل نہیں ہوتی اور نہ ہی کوئی ایسی ونڈو ہوتی ہے جس میں ڈیٹا آپ کا نہ رہے۔

فی منٹ 60 درخواستیں، جو اکاؤنٹ کے بجائے ٹوکن کے حساب سے گنی جاتی ہیں۔ اس حد سے تجاوز کرنے پر آپ کو Retry-After ہیڈر کے ساتھ 429 ایرر ملتا ہے، جس میں بتایا جاتا ہے کہ کتنے سیکنڈ انتظار کریں، اور کوئی چارج نہیں ہوتا یا ڈیٹا آدھا لکھا نہیں جاتا۔ CI اور پروڈکشن کے لیے الگ الگ ٹوکن رکھیں تاکہ شور والی بلڈ آپ کی ایپ کو متاثر نہ کرے۔

کوئی مقررہ فہرست نہیں ہے۔ ویلیڈیٹر کسی بھی BCP-47 ٹیگ کو قبول کرتا ہے جسے ICU پہچانتا ہے، جو کہ اس جدول میں 708 لوکیلز ہیں، اور اس کے علاوہ دیگر ٹیگز کے لیے ساختی فال بیک موجود ہے۔ پروجیکٹ میں ایک لوکیل شامل کریں اور اگلی پش میں وہ شامل ہو جائے گا۔

بیس: 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۔ ان میں سے سات میں جمع (plurals) کی صلاحیت ہے، اور فائل اسی شکل میں واپس آتی ہے جس شکل میں بھیجی گئی تھی۔

جی ہاں۔ 12 ویب ہک ایونٹس ہیں، جن میں batch.completed، translation.reviewed، qa.completed اور source_drift.repaired شامل ہیں۔ ہر ڈیلیوری HMAC سائنڈ ہوتی ہے اور ٹائم اسٹیمپ ہیڈر کے ساتھ آتی ہے تاکہ آپ اس کی تصدیق کر سکیں، اور GET /v1/webhooks/events کیٹلاگ کو ہر ایک کے نمونہ پیلوڈ کے ساتھ واپس کرتا ہے۔

جی ہاں۔ npx -y @transglot/mcp آپ کے پروجیکٹ ٹوکن پر 17 ٹولز فراہم کرتا ہے، تاکہ اسسٹنٹ ترجمہ پڑھ سکے، لکھ سکے، زبان شامل کر سکے، رن شروع کر سکے، بیچ چیک کر سکے یا گلاسری میں ترمیم کر سکے۔ یہ وہی API اور وہی اجازتیں ہیں، جو curl کے بجائے ایجنٹ رن ٹائم سے حاصل کی جاتی ہیں۔

جی ہاں۔ GitHub Action (transglot/transglot-action@v1) اور CLI دونوں ان اینڈ پوائنٹس کو ریپ کرتے ہیں۔ جب کسی رو کو مسترد کیا جاتا ہے، تو transglot push --wait ایکسٹ کوڈ 4 کے ساتھ ختم ہوتا ہے اور Action اس رن پر اپنا جاب ناکام کر دیتا ہے۔ مرج روکنے کے لیے، اسے pull requests پر چلائیں جس کا commit input none پر سیٹ ہو، ایک قدم شامل کریں جو ناکام ہو جائے اگر کھینچی گئی فائل میں کوئی کلید موجود نہ ہو، اور جاب کو برانچ پروٹیکشن میں ضروری چیک بنائیں۔

چار ڈیٹرمنسٹک گیٹس ہر رو کو پڑھتے ہیں: پلیس ہولڈرز، جمع کی اشکال، گلاسری کی اصطلاحات اور لمبائی۔ ٹوٹا ہوا پلیس ہولڈر، غائب جمع کی شکل یا ممنوعہ گلاسری کی اصطلاح کو ایک خودکار اصلاحی ری ٹرائ ملتا ہے، اور اگر یہ اب بھی ناکام رہے تو رو کو لکھنے کے بجائے مسترد کر دیا جاتا ہے۔ وہ رو جو صرف اپنی لمبائی سے تجاوز کرتی ہے اسے لکھا جاتا ہے، مسترد نہیں کیا جاتا۔ GET /v1/batches/:id?include=failures مسترد شدہ قطاریں اور ان کی وجہ درج کرتا ہے۔

نہیں۔ /v1 صرف اینڈ پوائنٹس اور رسپانس فیلڈز کا اضافہ کرتا ہے؛ وہ فیلڈ جسے آپ پہلے سے پارس کر رہے ہیں اس کی شکل نہیں بدلتی یا غائب نہیں ہوتی۔ کوئی بریکنگ چینج نئے ورژن پریفیکس کے تحت جاری ہوگی، جو محفوظ ہے اور ابھی خالی ہے۔ API چینج لاگ ہر ریلیز کو ریکارڈ کرتا ہے۔