added
نموذج مفتاح النشر، حيث يكون رمز الحامل هو المشروع نفسه. وهو ما يعمل عليه كل من CLI وإجراء GitHub.
api v1 · الحالي
سجل تغييرات واجهة برمجة التطبيقات.
لم تتم إزالة أي شيء.
/v1 لا يضيف إلا ميزات جديدة. تظهر نقاط النهاية الجديدة وحقول الاستجابة الجديدة ضمن البادئة نفسها، ولا يتغير شكل الحقل الذي تقوم بتحليله بالفعل أو يختفي. سيتم إصدار التغييرات الجذرية تحت بادئة إصدار جديدة، وهي محجوزة ولا تزال فارغة.
v1/api/v1
البادئة الوحيدة قيد الاستخدام
البادئة الوحيدة قيد الاستخدام
5 إصدارات
11 تغييرات، ولا يوجد منها تغييرات جذرية
شكل السجل
بادئة إصدار واحدة، بدون عمليات إزالة.
ثلاثة من هذه العناصر الأربعة هي خصائص لهذا السجل نفسه. والرابع هو حجم كتالوج webhook التي تقدمها واجهة برمجة التطبيقات.
5
إصدارات على /v1، وكلها إضافية
1
بادئة الإصدار قيد الاستخدام. التالية محجوزة وفارغة
0
تغييرات جذرية منذ إطلاق واجهة برمجة التطبيقات
12
أحداث webhook الموقعة. المصدر: App\Enums\WebhookEvent
مؤرخة حسب الإصدار، وليس حسب semver
استخدم مفاتيح الأسهم للتنقل
2026-07-08
توصيل CDN، الاستخدام وملعب API
July 8, 2026 · 4 تغييرات
05 / 05
added
/v1/incontext/translations، و/screenshots و/suggest تدعم المحرر المرئي، مع تقييد CORS بهذا المسار فقط ولا شيء آخر.
POST /v1/incontext/session يتبادل مفتاحًا قابلًا للنشر وأصلًا لرمز جلسة ذو نطاق محدود.
improved
يُبلغ التصدير ثنائي اللغة الآن عما لم يتمكن من إرجاعه بالكامل بدلاً من استبدال نص المصدر بصمت. الحقول الحالية دون تغيير، وهو الهدف الأساسي من وضعها في رأس الاستجابة.
أضاف GET /v1/pull رؤوس الاستجابة X-Skipped-Keys وX-Missing-Source-Keys.
added
بالإضافة إلى /v1/glossary/import و/export و/extract، مما يسمح بنقل قاعدة المصطلحات داخل وخارج النظام دون فتح وحدة التحكم.
دعم كامل لعمليات CRUD لقاعدة المصطلحات عبر واجهة برمجة التطبيقات: GET وPOST وPUT وDELETE على /v1/glossary.
added
تظهر النتائج في صفوف الترجمة التي تسحبها بالفعل، لذا لا حاجة لاستطلاع بيانات جديدة.
يُفعّل POST /v1/qa/run فحص جودة ذكي ويعيد معرف التشغيل.
added
اشترك لكل نقطة نهاية. توجد القائمة نفسها في App\Enums\WebhookEvent، والتي تحتوي حالياً على اثنتي عشرة حالة؛ اعتمد على عدد الحالات في الـ enum بدلاً من هذا السطر.
تصدر الـ Webhooks الموقَّعة أحداث المفاتيح والترجمة واللغة والقاموس وضمان الجودة بجانب زوج الدفعة الأصلي.
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 يحمل وعدًا بالتوافق لا تحمله إصدارات المنتج. لا ينبغي للمطور الذي يتحقق مما إذا كان التكامل لا يزال يعمل أن يضطر إلى التمرير past أعمال الميزات لمعرفة ذلك.
كيف أضيف الـ API إلى خطتي؟
يبدأ رمز bearer على خطة Starter بسعر 19 دولارًا شهريًا. تغطي الخطة المجانية وحدة التحكم ولكن لا يمكنها إنشاء رمز، بينما تعتمد CLI، و GitHub Action، و webhooks، و MCP على نفس الرمز.
أين المرجع لنقاط النهاية نفسها؟
في صفحة API: المصادقة، ونقاط النهاية، وحد المعدل، وتنسيقات الملفات، وفهرس webhooks. هذه الصفحة هي فقط سجل لما تغير ومتى.
يعمل مع ما تشغله بالفعل
41 موصلات، جاهزة مسبقًا.
العقد هو المنتج
البناء على واجهة برمجة التطبيقات التي لا تتغير.
تتوفر واجهة برمجة التطبيقات (API) في خطة Starter وما فوقها. الخطة المجانية تكلف 0 دولار وتتضمن 100,000 كلمة للبدء (25,000 عند التسجيل، و75,000 بعد التحقق عبر الهاتف)، ثم 10,000 كلمة شهرياً بعد ذلك، دون دعم لواجهة برمجة التطبيقات أو الويب هوكس.