ForHosting KIT · المستندات وملفات PDF

إضافة حقل توقيع إلى PDF

تتحقق واجهة برمجة التطبيقات لإضافة حقل توقيع إلى PDF من الأمر الوحيد الذي يُفسد سير عمل التوقيع بصمت: هل المستطيل الذي تنوي استخدامه لحقل التوقيع الرقمي يتسع فعلًا داخل الصفحة.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

ترسل حجم الصفحة وموضع الحقل بوحدات نقاط PDF؛ فتؤكد الواجهة أن الحقل يقع بالكامل داخل حدود الصفحة وتصف موضعه — الهوامش من كل جانب، والربع الذي يقع فيه مركزه، ونسبة ما يغطيه من الصفحة. وإذا خرج أي حد من حدوده خارج الصفحة، ترفض الموضع مع شرح دقيق للحد الذي تم تجاوزه، قبل أن تهدر عملية توقيع على حقل لن يراه أحد أبدًا.

طريقة الاستخدام

أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.

راجع بياناتك

اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.

كيف أستخدم هذه الإمكانية؟

أكمل الحقول أعلاه وشغّلها في هذه الصفحة. يوضح النموذج أي بيانات تحتاج إلى تصحيح.

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

POSThttps://api.kit.forhosting.com/pdf/digital-sign-field

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

curl -X POST https://api.kit.forhosting.com/pdf/digital-sign-field \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}'
{
  "page_width": 612,
  "page_height": 792,
  "x": 72,
  "y": 72,
  "width": 200,
  "height": 50
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.digital_sign_field",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

max_mb25
max_pages200
HTTPالرمزالمعنى
401unauthorizedمفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
402insufficient_balanceرصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
404unknown_typeنوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
429rate_limitedتجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←