امضای PDF

سرویس «امضای PDF» یک PDF امضانشده را با تصویر امضای همان شخص مهر می‌کند و PDF امضاشده را برمی‌گرداند. محل مهر را با x، y، width و height خودتان می‌دهید.

امضای PDF چه مشکلی را حل می‌کند؟

قرارداد تا وقتی روی خودِ فایل ننشیند در پرونده قابل اتکا نیست. این سرویس PDF و تصویر امضا را می‌گیرد و فایل امضاشده را همان لحظه پس می‌دهد تا آن را ذخیره کنید. شخص باید گواهی معتبر و یک کد یکبارمصرف تازه داشته باشد.

کاربردهای امضای PDF

امضای قرارداد و رضایت‌نامه — PDF نهایی را با تصویر امضای صاحب گواهی مهر کنید.
جای ثابت مهر روی فرم — مختصات کادر امضا را در درخواست می‌فرستید، نه به‌صورت پیش‌فرض پنهان.
نگه‌داشتن سند امضاشده — signedPdf را در پرونده می‌گذارید و signingTrackId را برای پیگیری همان درخواست نگه می‌دارید.

مزایای امضای PDF

خروجی خودِ PDF است — signedPdf بیس۶۴ همان فایل امضاشده است.
شناسه پیگیری همان درخواست است — signingTrackId برابر trackId همین فراخوانی است.
نوع فایل کنترل می‌شود — PDF باید application/pdf باشد و تصویر امضا image/png یا image/jpeg.

چه چیزی از امضای PDF دریافت می‌کنید؟

signedPdf، signingTrackId و providerCode (FN برای emzasan). جزئیات فایل و نمونه در مستندات فنی است.

جریان کار امضای PDF

۱. گواهی را آماده کنید — استعلام کد ملی، و ثبت‌نام فقط اگر VALID نباشد.
۲. OTP تازه بگیرید — کد ثبت‌نام را اینجا نفرستید.
۳. PDF و تصویر امضا را بفرستید — به درگاه به‌صورت multipart. همراه آن کد ملی امضاکننده، pin، otp و چهار عدد محل مهر. provider روی query است.
۴. فایل امضاشده را ذخیره کنید — بیس۶۴ را به PDF برگردانید و signingTrackId را کنارش بنویسید.

نحوه شروع امضای PDF

این سرویس با رویکرد Client Credential فراخوانی می‌شود. اسکوپ مورد نیاز: sign:digital-sign:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع.

محدودیت‌ها و نکات امضای PDF

کلاینت فایل را multipart می‌فرستد. هر فایل قبل از سرویس امضا به { fileData, name, mimetype, size } تبدیل می‌شود. fileData بیس۶۴ است و size طول بایت است، نه طول رشته بیس۶۴.
تصویر غیر از png و jpeg رد می‌شود.
pin و otp هر کدام ۴ تا ۸ رقم‌اند.
مختصات را رشته عددی بفرستید.

سوالات متداول امضای PDF

چرا هم multipart است هم آبجکت فایل؟

درگاه از کلاینت multipart می‌گیرد و همان فایل را با fileData، name، mimetype و size به سرویس امضا می‌دهد. فراخوانی مستقیم سرویس هم باید همان آبجکت را بفرستد.

signingTrackId را از کجا بردارم؟

همان trackId این درخواست است. جدا نسازید.

مستندات فنی کجاست؟

صفحه مشخصات API.

چه نوع احراز هویتی لازم است؟

Grant type: client_credentials. جزئیات در راهنمای توکن.

مستندات فنی امضای PDF

مشاهده مستندات فنی «امضای PDF» — endpoint، پارامترها، نمونه درخواست و پاسخ.