إضافة حقل توقيع إلى PDF
حقل بمقاس 200 في 50 نقطة يبدأ من 72، 72 على صفحة Letter مقاسها 612 في 792 يقع داخلها، مع 340 نقطة فارغة يمينًا و670 أعلاه، وفي الربع السفلي الأيسر. تحقق من موضع التوقيع قبل ختمه. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- عرض الصفحة
- 612
- ارتفاع الصفحة
- 792
- X
- 72
- Y
- 72
- العرض
- 200
- الارتفاع
- 50
- نظام الإحداثيات
- pdf_points_origin_bottom_left
- الربع
- bottom_left
- المساحة (نقاط)
- 10,000
- نسبة التغطية
- 2.063115
ترسل حجم الصفحة وموضع الحقل بوحدات نقاط PDF؛ فتؤكد الواجهة أن الحقل يقع بالكامل داخل حدود الصفحة وتصف موضعه — الهوامش من كل جانب، والربع الذي يقع فيه مركزه، ونسبة ما يغطيه من الصفحة. وإذا خرج أي حد من حدوده خارج الصفحة، ترفض الموضع مع شرح دقيق للحد الذي تم تجاوزه، قبل أن تهدر عملية توقيع على حقل لن يراه أحد أبدًا.
لماذا يفشل موضع حقول التوقيع في بيئة الإنتاج
كل سير عمل للتوقيع الإلكتروني ينتهي إلى الهندسة: مستطيل على صفحة يجب أن تظهر فيه أداة التوقيع أو الختم أو تعليق التوقيع الرقمي. وكل فريق يؤتمت توقيع المستندات يشحن في النهاية خطأ تخطيط — قالب عقد يُعاد تدفقه، صفحة ممسوحة ضوئيًا تصل بحجم A4 بدلًا من Letter، إحداثية حُسبت لصفحة عمودية تحط على صفحة أفقية، فينتهي حقل التوقيع خارج الصفحة المرئية. في بعض الأدوات يُطبَّق التوقيع رغم ذلك، فيظهر المستند موقَّعًا في لوحة التحكم لكنه لا يُظهر شيئًا في الصفحة التي يفتحها إنسان.
تصف الصفحة والمستطيل، فتؤكد الواجهة الموضع بوصف هندسي كامل أو ترفضه مسماةً الحد الذي جرى تجاوزه بدقة — من اليسار، من الأسفل، بعد الحد الأيمن أو بعد الحد العلوي. استدعاء تحقق واحد يحل محل الحادثة اللاحقة.
الإحداثيات والوحدات وما تُرجعه الواجهة
جميع القيم بوحدات نقاط PDF — اثنتان وسبعون نقطة في البوصة — ونقطة الأصل في الزاوية السفلية اليسرى من الصفحة، وx يزداد نحو اليمين وy نحو الأعلى، وهو نظام الإحداثيات ذاته الذي تستخدمه تعليقات حقول التوقيع في PDF أصالةً. عند النجاح، تُعيد الاستجابة المستطيل المُطبَّع، وتذكر الحدود المطلقة الأربعة، والهامش المتبقي من كل جانب من جوانب الصفحة، ونقطة المركز، وربعًا مقروءًا مثل bottom-left، ومساحة الحقل بالنقاط المربعة، والنسبة المئوية التي يغطيها من الصفحة، إضافةً إلى وصف من سطر واحد يمكن إدراجه مباشرةً في سجل أو أثر تدقيق.
وعند الفشل، تحمل رسالة الخطأ الأرقام المخالفة: أي إحداثية نزلت عن الصفر أو أي حد محسوب تجاوز أي بُعد من أبعاد الصفحة. العمليات الحسابية هندسة مستطيلات خالصة مع قيم مقربة إلى ستة أرقام عشرية، ولذلك ينتج الطلب نفسه دائمًا مخرجات متطابقة بايتًا ببايت على أي آلة.
أين يندرج في خط أنابيب التوقيع
استخدمه بوابةً قبل أي عملية تكتب حقل توقيع: بناة القوالب يتحققون من كل حقل عند حفظ القالب، ومهام التوقيع الدفعية تتحقق مستندًا مستندًا قبيل الختم مباشرةً، وخطوط أنابيب الاستيعاب تتحقق عند الاشتباه في عدم تطابق حجم الصفحة بين القالب والملف الوارد. ولأن القدرة هندسة خالصة دون إدخال وإخراج للملفات، فهي سريعة بما يكفي للعمل على كل مستند في دفعة دون تردد، وحتمية بما يكفي لتُحفظ مخرجاتها دليلًا على موضع جرى التحقق منه.
الشيفرة نفسها التي تجيب عن الواجهة تعمل مجانًا في متصفحك في هذه الصفحة، فيستطيع مهندس الدعم إعادة إنتاج الموضع المعيب لدى العميل بكتابة الأرقام الستة نفسها التي أرسلها خط الأنابيب.
حالات الاستخدام
التحقق من قالب توقيع قبل نشره
تحقق من كل حقل توقيع في القالب مقابل حجم الصفحة المستهدف عند الحفظ، بحيث يكتشف المؤلف الحقل الموضوع في غير موضعه، لا أول موقِّع.
حماية مهمة توقيع دفعية
افحص الموضع لكل مستند قبيل الختم مباشرةً؛ فالمهمة التي كانت ستضع الحقل خارج الصفحة تفشل بصوت مسموع في ذلك المستند بدلًا من إرسال توقيع غير مرئي بصمت.
تصحيح توقيع مفقود أبلغ عنه عميل
أعد تشغيل حجم الصفحة والمستطيل الدقيقين من تذكرة الدعم وسترى فورًا أي حد من حدود الصفحة تجاوزه الحقل، مع الأرقام التي تثبت ذلك.
الأسئلة الشائعة
كم التكلفة؟
وهو مجاني أيضًا للتشغيل في متصفحك في هذه الصفحة.
هل يعدّل ملف PDF الخاص بي؟
لا. إنه يتحقق من الهندسة فقط — ترسل ستة أرقام لا ملفًا. لا يُرفع شيء ولا يُخزَّن ولا يُكتب.
ما نظام الإحداثيات المستخدم؟
نقاط PDF الأصلية: 72 نقطة في البوصة، الأصل في الزاوية السفلية اليسرى من الصفحة، x نحو اليمين وy نحو الأعلى — النظام نفسه الذي تستخدمه تعليقات حقول التوقيع.
هل ينجح حقل يقع على حافة الصفحة تمامًا؟
نعم. الحقل الذي يساوي حده الأيمن عرض الصفحة يقع بالكامل في الداخل؛ تُرفض فقط الحدود الواقعة قطعًا خارج حدود الصفحة.
هل النتيجة حتمية؟
نعم. إنها حسابات مستطيلات خالصة مع تقريب إلى ستة أرقام عشرية، ولذلك يُرجع الإدخال نفسه دائمًا مخرجات متطابقة بايتًا ببايت.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة 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}'const res = await fetch("https://api.kit.forhosting.com/pdf/digital-sign-field", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"page_width": 612,
"page_height": 792,
"x": 72,
"y": 72,
"width": 200,
"height": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/digital-sign-field",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"page_width": 612,
"page_height": 792,
"x": 72,
"y": 72,
"width": 200,
"height": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/digital-sign-field", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"page_width":612,"page_height":792,"x":72,"y":72,"width":200,"height":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/digital-sign-field", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"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 فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_mb | 25 |
max_pages | 200 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تتحقق واجهة برمجة التطبيقات لإضافة حقل توقيع إلى PDF من الأمر الوحيد الذي يُفسد سير عمل التوقيع بصمت: هل المستطيل الذي تنوي استخدامه لحقل التوقيع الرقمي يتسع فعلًا داخل الصفحة.
لماذا يفشل موضع حقول التوقيع في بيئة الإنتاج
نقطة النهاية add pdf signature field موجودة لتلتقط هذه الفئة من الأخطاء في اللحظة الوحيدة التي يكون فيها إصلاحها رخيصًا: قبل إنشاء الحقل.
الإحداثيات والوحدات وما تُرجعه الواجهة
تمرر عرض الصفحة وارتفاعها إضافةً إلى مستطيل الحقل على الصورة x وy وwidth وheight.
أين يندرج في خط أنابيب التوقيع
ادفع لكل استدعاء $0.002 فقط عندما تؤتمت العملية؛ أما استكشاف التخطيطات وتصحيح إحداثية معينة فاشلة فلا يكلف شيئًا.
أسئلة تقنية
ماذا يحدث إذا كان الحقل خارج الصفحة؟
يفشل الطلب بخطأ invalid_input تسمي رسالته الحد الذي تم تجاوزه وتعرض الأرقام المخالفة، مثل حد أيمن قدره 700pt في صفحة عرضها 612pt.