سرویس «استعلام کاربر امضای دیجیتال با کد ملی» می‌گوید این شخص گواهی دارد یا نه. اگر certStatus برابر VALID باشد، ثبت‌نام را انجام ندهید.
استعلام کاربر امضای دیجیتال با کد ملی چه مشکلی را حل می‌کند؟
ثبت‌نام دوباره برای کسی که گواهی معتبر دارد درخواست را خراب می‌کند و مشتری را معطل می‌کند. این استعلام همان تصمیم را قبل از ثبت‌نام می‌گیرد: ادامه به امضا، یا اول ثبت‌نام.
کاربردهای استعلام کاربر امضای دیجیتال با کد ملی
- شروع جریان امضا — بعد از اولین OTP، وضعیت گواهی را بخوانید.
- مشتری برگشتی — اگر گواهی هنوز معتبر است مستقیم به امضای PDF بروید.
- نمایش وضعیت در پنل — تاریخ صدور و انقضا را کنار پرونده شخص نشان دهید.
مزایای استعلام کاربر امضای دیجیتال با کد ملی
- جلوگیری از ثبت‌نام تکراری —
VALIDیعنی ثبت‌نام لازم نیست. - نام فیلدها یکدست است — پاسخ ارائه‌دهنده به camelCase برمی‌گردد، مثل
certStatusوgivenName. - بدون پیامک تایید برای خودِ استعلام — خواندن وضعیت با Client Credential است. OTP مال ثبت‌نام و امضا است.
چه چیزی از استعلام کاربر امضای دیجیتال با کد ملی دریافت می‌کنید؟
شناسه کاربر، نام، موبایل، سریال گواهی، نوع و وضعیت گواهی، زمان صدور و انقضا، و providerCode. جزئیات در مستندات فنی است.
جریان کار استعلام کاربر امضای دیجیتال با کد ملی
- ۱. گرفتن توکن — اسکوپ
sign:digital-sign-user-by-national-id:post. - ۲. فرستادن کد ملی —
providerاختیاری است و پیش‌فرضemzasanاست. - ۳. خواندن
certStatus— مقدارVALIDیعنی بروید سراغ OTP تازه و سپس امضا.
نحوه شروع استعلام کاربر امضای دیجیتال با کد ملی
این سرویس با رویکرد Client Credential فراخوانی می‌شود. اسکوپ مورد نیاز: sign:digital-sign-user-by-national-id:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع.
محدودیت‌ها و نکات استعلام کاربر امضای دیجیتال با کد ملی
- این سرویس گواهی جدید نمی‌سازد و PDF امضا نمی‌کند.
- وضعیت را همان لحظه بخوانید. گواهی منقضی را با ثبت‌نام تازه عوض کنید، نه با امضای قدیمی.
providerCodeدر پاسخ برایemzasanبرابرFNاست. این با مقدارproviderدر درخواست یکی نیست.
سوالات متداول استعلام کاربر امضای دیجیتال با کد ملی
VALID دقیقا یعنی چه؟
گواهی شخص معتبر است و ثبت‌نام لازم نیست. برای امضا هنوز OTP تازه لازم است.
اگر شخص پیدا نشود چه می‌شود؟
ثبت‌نام انجام نشده. مسیر ثبت‌نام گواهی را بعد از OTP طی کنید.
مستندات فنی کجاست؟
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
مستندات فنی استعلام کاربر امضای دیجیتال با کد ملی
مشاهده مستندات فنی «استعلام کاربر امضای دیجیتال با کد ملی» — endpoint، پارامترها، نمونه درخواست و پاسخ.