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