added
ڈپلائے-کی ماڈل، جہاں بیرر ٹوکن ہی پروجیکٹ ہے۔ یہی وہ چیز ہے جس پر CLI اور GitHub Action دونوں چلتے ہیں۔
api v1 · موجودہ
API چینج لاگ۔
کچھ بھی حذف نہیں کیا گیا۔
/v1 میں صرف نئی چیزیں ہی شامل ہوتی ہیں۔ نئے اینڈ پوائنٹس اور نئے رسپانس فیلڈز اسی پریفکس کے اندر آتے ہیں، اور وہ فیلڈ جسے آپ پہلے سے پارس کر رہے ہیں اس کی ساخت یا شکل کبھی نہیں بدلتی اور نہ ہی یہ غائب ہوتا ہے۔ کوئی بھی بریکنگ چینج ایک نئے ورژن پریفکس کے تحت جاری کیا جائے گا، جو محفوظ ہے اور فی الحال خالی ہے۔
v1/api/v1
استعمال میں موجود واحد پریفکس
استعمال میں موجود واحد پریفکس
5 ریلیزز
11 تبدیلیاں، جن میں سے کوئی بھی بریکنگ نہیں ہے
لاگ کی ساخت
ایک ورژن پریفکس، کوئی حذف شدگی نہیں۔
ان چار میں سے تین اس لاگ کی اپنی خصوصیات ہیں۔ چوتھا وہ ویب ہک کیٹلاگ کا سائز ہے جو API فراہم کرتا ہے۔
5
/v1 پر ریلیزز، ہر ایک اضافیتی
1
استعمال میں ورژن پریفکس۔ اگلا والا محفوظ اور خالی ہے
0
API لانچ ہونے کے بعد سے بریکنگ چینجز
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 میں موجود ہے، جس میں آج بارہ کیسز ہیں؛ اس لائن کے بجائے enum کو گنیں۔
دستخط شدہ ویب ہکس اصل بیچ کے جوڑے کے ساتھ کلید، ترجمہ، زبان، لغت اور 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 یا ویب ہکس نہیں۔