اندپوینت و دسترسی استعلام کاربر امضای دیجیتال با کد ملی
این صفحه مستندات فنی فراخوانی POST /sign/v2/clients/{clientId}/digitalSign/userByNationalId است.
Scope: sign:digital-sign-user-by-national-id:post
Grant type: client_credentials
دسته‌بندی OpenAPI: امضای دیجیتال. شناسه عملیات: signDigitalSignUserByNationalIdPost.
معرفی استعلام کاربر امضای دیجیتال با کد ملی
وضعیت گواهی شخص. `certStatus` برابر `VALID` یعنی ثبت‌نام لازم نیست.
ورودی و خروجی استعلام کاربر امضای دیجیتال با کد ملی
ورودی‌های اصلی: شناسه کلاینت، کد پیگیری، کدملی.
فیلدهای مهم پاسخ: کد ملی، givenName، surname، شماره موبایل، certSerial، caName، وضعیت گواهی، certType.
جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.
کاربرد فنی استعلام کاربر امضای دیجیتال با کد ملی
وضعیت گواهی شخص. certStatus برابر VALID یعنی ثبت‌نام لازم نیست.
پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.
در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.
برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «استعلام کاربر امضای دیجیتال با کد ملی» مراجعه کنید.
عملیات مرتبط با استعلام کاربر امضای دیجیتال با کد ملی
- ثبت‌نام گواهی امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/enroll - ثبت‌نام گواهی امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/enroll - درخواست کد یکبارمصرف امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/otpRequest - درخواست کد یکبارمصرف امضای دیجیتال —
POST /sign/v2/clients/{clientId}/digitalSign/otpRequest - امضای PDF —
POST /sign/v2/clients/{clientId}/digitalSign/sign