تخطَّ إلى المحتوى الرئيسي
ENAR

واجهة برمجة التطبيقات

أتمت التحويلات من خوادمك عبر واجهة REST غير متزامنة.

المصادقة

كل طلب يحتاج ترويسة X-API-Key. أنشئ مفتاحك من لوحة التحكم — يُعرض النص الأصلي مرة واحدة فقط.

Request header

X-API-Key: mt_live_a1b2c3d4e5f6...

كيف تعمل

كل عملية غير متزامنة. ترفع ملفك فيعيد الخادم معرّف مهمة فوراً، ثم تستعلم عن الحالة حتى تكتمل. هذا يعني أن التحويل الطويل لا يُبقي اتصال HTTP مفتوحاً.

1. Submit a job

curl -X POST https://your-domain/api/v1/pdf/compress \
  -H "X-API-Key: mt_live_..." \
  -F "[email protected]" \
  -F "level=high"

Response — 202 Accepted

{
  "jobId": "8f2a1c4e-...",
  "status": "processing",
  "statusUrl": "https://your-domain/api/v1/jobs/8f2a1c4e-..."
}

2. Poll until complete

curl https://your-domain/api/v1/jobs/8f2a1c4e-... \
  -H "X-API-Key: mt_live_..."

Response — completed

{
  "jobId": "8f2a1c4e-...",
  "status": "completed",
  "progress": 100,
  "durationMs": 1840,
  "outputs": [
    {
      "fileName": "report-compressed.pdf",
      "sizeBytes": 481203,
      "contentType": "application/pdf",
      "downloadUrl": "https://your-domain/api/download/eyJ...",
      "expiresAt": "2026-08-17T12:30:00Z"
    }
  ]
}
روابط التحميل موقّعة وتنتهي صلاحيتها. حمّل نتيجتك قبل انتهاء الصلاحية المذكورة في expiresAt.

النقاط النهائية

POST/api/v1/pdf/to-wordConvert a PDF into an editable Word document.
POST/api/v1/pdf/to-excelExtract tabular data from a PDF into XLSX.
POST/api/v1/pdf/compressReduce PDF file size. Form field: level.
POST/api/v1/pdf/mergeCombine several PDFs. Send two or more files.
POST/api/v1/pdf/splitSplit a PDF. Form field: pages.
POST/api/v1/image/to-pdfBuild a PDF from one or more images.
POST/api/v1/pdf/to-imageRender PDF pages as images. Form field: dpi.
POST/api/v1/ocrRecognise text in a scanned PDF. Form field: language.
GET/api/v1/jobs/{jobId}Poll job status and collect download links.
GET/api/v1/accountRead the quota and rate limit for your key.

الأخطاء

ترجع كل الأخطاء بنفس الشكل، مع رمز ثابت يمكن لبرنامجك التعامل معه.

{
  "code": "FILE_TOO_LARGE",
  "message": "The file is too large.",
  "correlationId": "0HN7...",
  "details": { "actualBytes": 251658240, "limitBytes": 209715200 }
}

رموز شائعة: FILE_TOO_LARGE، UNSUPPORTED_FORMAT، PDF_ENCRYPTED، QUOTA_EXCEEDED، RATE_LIMITED، PROCESSING_FAILED.

الحدود

المفتاح الافتراضي يسمح بـ 60 طلباً في الدقيقة. تجاوز الحد يعيد 429 مع الرمز RATE_LIMITED. استعلم عن ‎/api/v1/account لمعرفة حصتك المتبقية.

أنشئ مفتاح API من لوحة التحكم