توکن

توکن پیامکی: مرحله ۳: درخواست توکن

<!--seo-open-->

سرویس «مرحله ۳: درخواست توکن» (SMS/OTP) در دسته توکن Authorization Code پیامکی (OAuth2 SMS) فینوتک. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی پس از رضایت کاربر با رویکرد Authorization Code است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

پس از دریافت code از مرحله ۲، سرویس درخواست توکن را فراخوانی کنید.

آدرس API:

POST /dev/v2/oauth2/token

Grant type: authorization_code · auth_type: SMS

Headers

مقادیر زیر باید در هدر قرار بگیرد:

Content-Type: application/json
Authorization: Basic {AuthenticationString}

مقدار AuthenticationString باید برابر Base64 از اطلاعات برنامه شما به صورت YOURCLIENTID:YOURCLIENTSECRET باشد.

Basic Zmlyc3RhcHA6NjkzMmRkZGI5MjdiNzZlNTQ5OTc=

Notes

فرستادن تمام پارامترهای Body الزامی است.

نکته مهم: تمامی مقادیر دریافت‌شده در پاسخ این سرویس را ذخیره کنید. کد ملی و اسکوپ‌ها برای فراخوانی سرویس‌ها و تاریخ ایجاد و عمر توکن برای کنترل زمان انقضای توکن مورد نیاز هستند.

redirect_uri باید با آدرس بازگشتی ارسال‌شده در مرحله ۱ برابر باشد.

برای گرفتن توکن کشاورزی فیلد bank الزامی است.

post/dev/v2/oauth2/token/sms

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/dev/v2/oauth2/token/sms
  • Auth: HTTP basic

Request body

grant_type'authorization_code' required
codestring required

کد دریافتی از مرحله verify

auth_type'SMS' required
redirect_uristring uri required

باید با redirect_uri مرحله authorize یکسان باشد

bankstring

کد بانک

Response

توکن صادر شد

status'DONE' | 'FAILED'

Example response

{
  "result": {
    "type": "CODE",
    "auth_type": "SMS"
  }
}

Changes

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