API V2

إضافة ختم صورة إلى PDF

Connector ID: ImageStamp

يمكن إضافة ختم صورة إلى PDF لتحذير المستخدمين من استخدام محتوى المستند دون إذن. تمامًا مثل ختم النص المستخدم في PDF4me، يمكن أيضًا تحريك هذا النوع من الختمين بشكل عمودي أو أفقي.

  • Method: POST
  • Endpoint: /api/v2/ImageStamp

المعاملات

docNameString, Required

اسم ملف PDF المصدر بامتداد .pdf.

docContentbase64, Required

محتوى ملف الإدخال.

محاذاة الأفقيةString, Required

محاذاة الصورة الأفقية. القيم المسموح بها هي

  • Left - حافة الصفحة اليسرى
  • Center - المسافة المتساوية من اليسار واليمين
  • Right - حافة الصفحة اليمنى
محاذاة العموديةString, Required

محاذاة الصورة العمودية. القيم المسموح بها هي

  • Top - حافة الصفحة العلوية
  • Center - المسافة المتساوية من الأعلى والأسفل
  • Bottom - حافة الصفحة السفلية
محتوى ملف الصورةBase64, Required

تعيين محتوى صورة الختم من العملية المصدرية

اسم ملف الصورةString, Required

اسم ملف الصورة مع الامتداد المناسب - .png أو .jpeg

الحوافة الأفقية (مم)String, Required

الحوافة الأفقية في المليمترات (مم). القيمة الافتراضية هي 0. إذا كان المحاذاة الأفقية هو Left، فسيتم إعطاء فراغ من حافة الصفحة اليسرى. إذا كان Right، فسيتم إعطاء فراغ من حافة الصفحة اليمنى. إذا كان Center، فسيتم تجاهل هذا الحقل.

الحوافة الرأسية (مم)String, Required

الحوافة العمودية في المليمترات (مم). القيمة الافتراضية هي 0. إذا كان المحاذاة العمودية هو Top، فسيتم إعطاء فراغ من حافة الصفحة العلوية. إذا كان Bottom، فسيتم إعطاء فراغ من حافة الصفحة السفلية. إذا كان Center، فسيتم تجاهل هذا الحقل.

الحوافة الأفقية في البكسل (بكسل)String, Required

الحوافة الأفقية في البكسل (بكسل). القيمة الافتراضية هي 0. إذا كان المحاذاة الأفقية هو Left، فسيتم إعطاء فراغ من حافة الصفحة اليسرى. إذا كان Right، فسيتم إعطاء فراغ من حافة الصفحة اليمنى. إذا كان Center، فسيتم تجاهل هذا الحقل.

الحوافة الرأسية في البكسل (بكسل)string, Required

الهامش من الأصل العلوي لختم الصورة بالملليمتر

العتامةstring, Required

القيم بين 0 و 100. ‘0’ شفافية كاملة — 100 للعتامة الكاملة.

الصفحاتString, Required
  • حدد مؤشرات الصفحات كقيم أو نطاقات مفصولة بفواصل للمعالجة (على سبيل المثال، “0, 1, 2-” أو “1, 2, 3-7”).
  • إذا لم يتم تحديده، فسيتم معالجة كافة الصفحات بواسطة التكوين الافتراضي. يجب أن يكون الإدخال بتنسيق سلسلة.
الطول بالمليمتر (مم)String, Required

الطول بالمليمتر (مم). إذا كان 0، فسيتم استخدام الطول الافتراضي أو الطول المقاس حسب نسبة العرض/الطول.

العرض بالمليمتر (مم)String, Required

العرض بالمليمتر (مم). إذا كان 0، فسيتم استخدام العرض الافتراضي أو العرض المقاس حسب نسبة العرض/الطول.

الطول بالبكسل (بكسل)String, Required

طول ختم الصورة بالنقاط (بكسل)
مثال- 40pt.

العرض بالبكسل (بكسل)String, Required

عرض ختم الصورة بالنقاط (بكسل)
مثال- 40pt.

هو الخلفيةboolean, Required
Default: true

هو الخلفية

  • true
  • false
عرض فقط في الطباعةboolean, Required
Default: false

عرض فقط في الطباعة

  • true
  • false

الناتج

محتوى الملفBinary

محتوى الملف الخرج من إجراء PDF4me

اسم الملفString

اسم الملف الخرج من إجراء PDF4me

Header
Content-Type:application/json
Authorization: يرجى نسخ المفتاح من الرابط.

Payload

{
  "alignX": "center",
  "alignY": "top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "imageName": "stamp.jpg",
  "imageFile": "Please put image base64 content",
  "pages": "2",
  "heightInMM": "60",
  "widthInMM": "60",
  "heightInPx": "60",
  "widthInPx": "60",	
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "10",
  "marginYInPx": "10",	
  "opacity": 100,
  "isBackground": true,
  "showOnlyInPrint": false
}

أمثلة API PDF4me

CSharp(C#)
Java
JavaScript
Python
Salesforce
n8n
Google Script
AWS Lambda