سرویس های ارسال پیام کوتاه

صحت‌سنجی رمز یکبار مصرف (Verify)

<!--seo-open-->

سرویس «صحت‌سنجی رمز یکبار مصرف (Verify)» (SMS/OTP) در دسته ارسال و دریافت پیامک فینوتک. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

با وارد کردن کد دریافت‌شده توسط کاربر و traceId مرحله Initiate، صحت رمز بررسی شده و نتیجه نهایی اعلام می‌گردد.

Scope: messaging:otp-verify:post<br />

Grant type: client_credentials

مراحل فراخوانی

  1. ثبت درخواست ارسال رمز (Initiate)
  2. دریافت رمز توسط کاربر از طریق کانال انتخابی
  3. صحت‌سنجی رمز (این سرویس)
post/messaging/v2/clients/{clientId}/otp/verify

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/messaging/v2/clients/{clientId}/otp/verify
  • Auth: HTTP bearer

Path parameters

clientIdstring required

Query parameters

trackIdstring required

Correlation ID (max 40 alphanumeric characters). UUID recommended.

Request body

traceIdstring required

شناسه دریافتی از مرحله Initiate

otpstring required

کد وارد شده توسط کاربر

Example request

{
  "traceId": "atx_88234-9912",
  "otp": "554321"
}

Response

Successful response

responseCodestring
trackIdstring
statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.