الربط الآلي (API)

تتيح الواجهة للجهات المشتركة إرسال ملفاتها للترجمة مباشرة من أنظمتها، ومتابعة الحالة، وتحميل عرض السعر والملفات المسلَّمة. يصدر المكتب لكل جهة مفتاحاً خاصاً يبدأ بـ tl_، ويُرسَل في ترويسة كل طلب.

Subscribers can submit documents for translation from their own systems, track status and download the quote and the delivered files. Each organisation receives a private key (prefix tl_) sent as a Bearer token.

المصادقة

Authorization: Bearer tl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

إرسال طلب

ملف أو عدة ملفات – الأصل وملحقاته – أو رابط، مع اللغة والخيارات. الأنواع المقبولة: PDF وWord وExcel وPowerPoint والصور وZIP وRAR و7z، حتى 50 ميغابايت للملف و95 ميغابايت للطلب و20 ملفاً:

curl -X POST https://trilinga.uk/api/v1/requests \
  -H "Authorization: Bearer $TRILINGA_KEY" \
  -F file=@report.pdf -F file=@charts-data.zip -F lang=en -F target=ar -F summary=yes -F urgent= -F notes="Chapter 3 only"
curl -X POST https://trilinga.uk/api/v1/requests \
  -H "Authorization: Bearer $TRILINGA_KEY" -H "Content-Type: application/json" \
  -d '{"link": "https://example.org/report.pdf", "lang": "he", "target": "ar", "summary": "yes"}'

الرد: {"id": "20261015-1a2b3c4d", "status": "new"}. وعند رفض ملف يأتي الرد بالسبب واسم الملف، مثل {"error": "bad_type", "file": "x.exe"} – الرموز: bad_type، file_too_large، too_large، too_many، no_file.

المتابعة والتحميل

الطلبالوظيفة
GET /api/v1/requestsقائمة طلبات الجهة وحالاتها
GET /api/v1/requests/{id}حالة طلب واحد، ومبلغ عرض السعر، وتوفّر الملفات
GET /api/v1/requests/{id}/quoteتحميل عرض السعر PDF
GET /api/v1/requests/{id}/deliveryتحميل ملفات التسليم ZIP
GET /api/v1/accountالحزمة والرصيد المتبقي من الكلمات

الحالات

new وصل · quoted عرض سعر جاهز · approved موافَق عليه · in_progress قيد التنفيذ · delivered تم التسليم · rejected ملغى

Statuses: new → quoted → approved → in_progress → delivered (or rejected). Quotes for subscribers are deducted from the monthly word balance on approval.

ملاحظات