اندپوینت و دسترسی درخواست کد یکبارمصرف امضای دیجیتال
این صفحه مستندات فنی فراخوانی POST /sign/v2/clients/{clientId}/digitalSign/otpRequest است.
Scope: sign:digital-sign-otp-request:post
Grant type: client_credentials
دسته‌بندی OpenAPI: امضای دیجیتال. شناسه عملیات: signDigitalSignOtpRequestPost.
معرفی درخواست کد یکبارمصرف امضای دیجیتال
کد یکبارمصرف برای ثبت‌نام گواهی یا امضای PDF. همین اسکوپ برای هر دو مرحله است.
ورودی و خروجی درخواست کد یکبارمصرف امضای دیجیتال
ورودی‌های اصلی: شناسه کلاینت، کد پیگیری، کدملی، شماره موبایل.
فیلدهای مهم پاسخ: کد ارائه‌دهنده در سرویس امضا.
جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.
کاربرد فنی درخواست کد یکبارمصرف امضای دیجیتال
کد یکبارمصرف برای ثبت‌نام گواهی یا امضای PDF. همین اسکوپ برای هر دو مرحله است.
پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.
در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.
برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «درخواست کد یکبارمصرف امضای دیجیتال» مراجعه کنید.
عملیات مرتبط با درخواست کد یکبارمصرف امضای دیجیتال
- ثبت‌نام گواهی امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/enroll - ثبت‌نام گواهی امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/enroll - امضای PDF —
POST /sign/v2/clients/{clientId}/digitalSign/sign - امضای PDF —
POST /sign/v2/clients/{clientId}/digitalSign/sign - ابطال گواهی امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/revoke