درخواست کد یکبارمصرف امضای دیجیتال

سرویس «درخواست کد یکبارمصرف امضای دیجیتال» کد را برای ثبت‌نام گواهی یا برای گام امضا می‌فرستد. هر مرحله کد تازه می‌خواهد. اسکوپ هر دو مرحله یکی است.

درخواست کد یکبارمصرف امضای دیجیتال چه مشکلی را حل می‌کند؟

ثبت‌نام گواهی و امضای PDF بدون کد یکبارمصرف همان شخص انجام نمی‌شود. اگر کد مرحله ثبت‌نام را برای امضا هم استفاده کنید، درخواست رد می‌شود. این سرویس همان کد را، با کد ملی و موبایل، برای همان کاری که جلوتر است صادر می‌کند.

کاربردهای درخواست کد یکبارمصرف امضای دیجیتال

قبل از ثبت‌نام گواهی — کد را می‌گیرید و در ثبت‌نام می‌فرستید.
قبل از امضای PDF — حتی اگر گواهی از قبل VALID باشد، برای امضا یک کد تازه لازم است.
قبل از ابطال — ابطال هم کد یکبارمصرف می‌خواهد. این سرویس همان مسیر صدور کد است.

مزایای درخواست کد یکبارمصرف امضای دیجیتال

یک اسکوپ برای هر دو نوبت — ثبت‌نام و امضا هر دو sign:digital-sign-otp-request:post هستند.
بدون ساخت کانال پیامک جدا — ارسال کد با همین API انجام می‌شود.
قابل تکرار — هر فراخوانی کد جدید است. کد قبلی را برای مرحله بعد نگه ندارید.

چه چیزی از درخواست کد یکبارمصرف امضای دیجیتال دریافت می‌کنید؟

نتیجه شامل providerCode است. برای emzasan این مقدار FN است. جزئیات در مستندات فنی است.

جریان کار درخواست کد یکبارمصرف امضای دیجیتال

۱. گرفتن توکن — با اسکوپ sign:digital-sign-otp-request:post توکن Client Credential بگیرید.
۲. فرستادن کد ملی و موبایل — provider را emzasan بگذارید یا خالی بگذارید.
۳. دادن کد به مرحله بعد — کد را فقط برای ثبت‌نام، امضا، یا ابطالی که همان لحظه انجام می‌دهید استفاده کنید.

نحوه شروع درخواست کد یکبارمصرف امضای دیجیتال

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

محدودیت‌ها و نکات درخواست کد یکبارمصرف امضای دیجیتال

trackId برای هر فراخوانی تازه باشد.
کد مرحله ثبت‌نام را برای امضای PDF دوباره استفاده نکنید.
provider اگر نباشد emzasan است.

سوالات متداول درخواست کد یکبارمصرف امضای دیجیتال

این کد برای ثبت‌نام است یا برای امضا؟

برای هر دو، ولی هر بار یک فراخوانی جدا. کد ثبت‌نام را در امضا نفرستید.

اگر گواهی از قبل معتبر باشد باز هم کد لازم است؟

برای خودِ امضا بله. ثبت‌نام را رد می‌کنید، ولی قبل از امضای PDF دوباره OTP می‌گیرید.

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

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

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

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

مستندات فنی درخواست کد یکبارمصرف امضای دیجیتال

مشاهده مستندات فنی «درخواست کد یکبارمصرف امضای دیجیتال» — endpoint، پارامترها، نمونه درخواست و پاسخ.