api.transglot.ai/v1رمز حامل، مشروع واحدمرجع

ارفع ملفًا. احصل على كل اللغات مرة أخرى.

واجهة برمجة تطبيقات REST لترجمة تطبيقك. عملية POST واحدة لرفع ملف المصدر، وعملية GET واحدة لإعادة لغة جاهزة، ورمز حامل هو كل ما تحتاجه للمصادقة. أي شيء يدعم 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

كلمات شهريًا في خطة Starter، الخطة الأولى التي يمكنها إنشاء رمز مميز.

ابدأ مجاناً عرض واجهة المطورين

60 طلبًا في الدقيقة لكل رمز · كل استجابة 429 تتضمن رأس Retry-After · امنح بيئات CI والإنتاج رموزًا منفصلة

وحدة التحكم هي عميل API

ارفع، ترجم، تحقّق واسحب، كل منها نقطة نهاية REST.

كل صف في الصورة أدناه يمثل مسارًا خلفه: push، gates، glossary، batches و pull، وكلها يمكن الوصول إليها من شفرتك الخاصة باستخدام رمز المشروع. تعمل واجهة API التجريبية في لوحة التحكم على تشغيل المسارات ذات القراءة فقط مباشرةً مقابل مشروعك، بحيث ترى استجابة حقيقية أولاً.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

تقوم بتحميل ملف مصدر
POST/v1/push
يتم ملء لوحة gates
POST/v1/qa/run
تقوم بقفل مصطلح
POST/v1/glossary
تستعرض طريقة العرض الخاصة بالدفعات البيانات تلقائيًا
GET/v1/batches/:id
تقوم باسترجاع الترجمات
GET/v1/pull

مسار واحد لكل لوحة، 60 في الدقيقة، إمكانيات لكل رمز · إخراج ترجماتك هو أيضًا نقطة نهاية

إنه مجرد HTTP

أربعة أشياء تبنيها الفرق أولاً.

كل منها عبارة عن نقطة نهاية واحدة ورمز مشروع · ولا يستغرق أي منها بعد الظهر كاملاً

بوابة الدمج · ملف سير عمل واحد

اجعل طلب السحب يظهر باللون الأحمر عند فشل الترجمة.

cron · كل ليلة

ترجمة ملاحظات الإصدار بين عشية وضحاها، كل ليلة.

bot · اشتراك واحد

انشر إلى Slack في اللحظة التي تنتهي فيها الدفعة.

agent · mcp

امنح وكيل الذكاء الاصطناعي نفس الأدوات السبع عشرة التي تمتلكها.

طلبات في الدقيقة

لكل رمز، وليس لكل حساب، مع رأس Retry-After في كل استجابة 429 يوضح عدد الثواني للانتظار.

تنسيقات الملفات

ادفع واسحب التنسيق الذي يستخدمه مستودعك بالفعل. تبقى صيغ الجمع والعناصر النائبة سليمة في كلا الاتجاهين. سمّه باستخدام format= في أي من النداءين.

أحداث webhook

الفهرس الكامل، كل منها يحتوي على حمولة مثال بالشكل الدقيق الذي تحمله التسليمات الحقيقية. GET /v1/webhooks/events.

أدوات mcp

نفس رمز المشروع، يُسلم إلى وقت تشغيل الوكيل بدلاً من curl. npx -y @transglot/mcp.

الأسئلة الشائعة

ما يسأله المطورون قبل الطلب الأول.

كيف أقوم بالمصادقة مع واجهة Transglot API؟

أرسل رمز حامل: Authorization: Bearer $TRANSGLOT_TOKEN. ينتمي الرمز إلى مشروع واحد، لذلك لا يوجد معرف مشروع في المسار ولا مفتاح شامل للحساب قد يتم تسريبه. يمكنك إنشاء الرموز المميزة في صفحة المشروع ويحمل كل منها إمكانياته الخاصة: push، pull، manage، read، write.

هل واجهة برمجة التطبيقات (API) مجانية؟

لا. يبدأ رمز الحامل (bearer token) مع خطة المبتدئين بسعر 19 دولارًا شهريًا. تغطي الخطة المجانية وحدة التحكم فقط، وهي كافية لمعرفة ما إذا كان المنتج مناسبًا لاحتياجاتك، لكنها لا تسمح بإنشاء رمز. تعمل واجهة سطر الأوامر (CLI)، وإجراء GitHub، والويب هوكس، وMCP، وحزمة التسليم جميعها خلف نفس الرمز، لذا فهي متاحة معًا.

كيف أقوم برفع السلاسل النصية إلى Transglot؟

استخدم POST /v1/push مع الملف وتنسيقه، على سبيل المثال -F "file=@lang/en.json" -F "format=laravel_json". يستجيب النظام برمز 202 ويقوم بإضافة العملية إلى قائمة الانتظار. تتم ترجمة الصفوف التي تغيرت فعليًا فقط، لذا فإن رفع ملف دون تغييرات لا يكلف شيئًا.

كيف يمكنني استرداد ترجماتي؟

استخدم GET /v1/pull، بأي من التنسيقات العشرين المتاحة، وفي أي وقت تشاء. هذه هي نقطة النهاية التي تغلفها واجهة سطر الأوامر (CLI)، وتلك التي يشغلها ملعب واجهة برمجة التطبيقات مباشرة. لا توجد حاجة لتقديم طلب تصدير، ولا توجد فترة زمنية تتوقف فيها البيانات عن كونها ملكك.

ما هو حد معدل طلبات واجهة برمجة التطبيقات (API)؟

60 طلبًا في الدقيقة، تُحسب لكل رمز وليس لكل حساب. إذا تجاوزت الحد، ستحصل على استجابة 429 مع رأس Retry-After يوضح عدد الثواني التي يجب الانتظار خلالها، ولن يتم فرض أي رسوم أو كتابة بيانات جزئية. امنح بيئات التكامل المستمر (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، RESX، Markdown، Unity CSV وUnreal PO. سبعة منها تدعم صيغ الجمع، ويعود الملف بنفس الشكل الذي أُرسِل به.

هل يدعم Transglot الويب هوكس؟

نعم. هناك 12 حدثًا للويب هوك، بما في ذلك batch.completed، وtranslation.reviewed، وqa.completed، وsource_drift.repaired. كل عملية تسليم موقعة بـ HMAC مع رأس طابع زمني حتى تتمكن من التحقق منها، ويعيد GET /v1/webhooks/events الكتالوج مع عينة من الحمولة لكل حدث.

هل يوجد خادم MCP لوكلاء الذكاء الاصطناعي؟

نعم. يعرض الأمر npx -y @transglot/mcp 17 أداة عبر رمز مشروعك، بحيث يمكن للمساعد قراءة الترجمة وكتابتها وإضافة لغة وبدء تشغيل وفحص دفعة أو تعديل المسرد. إنها واجهة برمجة التطبيقات نفسها والأذونات نفسها، ولكن يتم الوصول إليها من بيئة تشغيل الوكيل بدلاً من curl.

هل يمكنني تشغيله في التكامل المستمر (CI)؟

نعم. كل من إجراء GitHub (transglot/transglot-action@v1) وواجهة سطر الأوامر يغلفان نقاط النهاية هذه. عند رفض صف، يخرج الأمر transglot push --wait بالرمز 4 ويفشل الإجراء في مهمته لهذا التشغيل. لإيقاف الدمج، شغّله على طلبات السحب مع تعيين مدخل الالتزام إلى none، وأضف خطوة تفشل عندما يفتقد ملف مسحب مفتاحًا، واجعل المهمة فحصًا مطلوبًا في حماية الفرع.

ماذا يحدث عندما تفشل الترجمة في فحص الجودة؟

أربع بوابات حتمية تقرأ كل صف: العناصر النائبة، وصيغ الجمع، ومصطلحات المسرد، والطول. يؤدي العنصر النائب المعطّل، أو صيغة الجمع المفقودة، أو مصطلح المسرد المحظور إلى محاولة تصحيح تلقائية واحدة، وإذا استمر الفشل يُرفض الصف بدلاً من كتابته. الصف الذي يتجاوز طوله فقط تتم كتابته ولا يُرفض. يسرد GET /v1/batches/:id?include=failures الصفوف المرفوضة وأسباب الرفض.

هل ستؤدي واجهة برمجة التطبيقات يومًا ما إلى كسر تكاملي؟

لا. /v1 تكتسب فقط نقاط نهاية جديدة وحقول استجابة؛ الحقل الذي تقوم بتحليله بالفعل لا يغير شكله أو يختفي. سيتم إصدار التغيير الكاسر تحت بادئة إصدار جديد، وهي محجوزة ولا تزال فارغة. يسجل سجل تغييرات واجهة برمجة التطبيقات كل إصدار.

يعمل مع ما تشغله بالفعل