توکن

گرفتن توکن Client Credential فینوتک

<!--seo-open-->

با این سرویس توکن OAuth2 فینوتک را با رویکرد Client Credential می‌گیرید؛ نیازی به رضایت کاربر بیرونی نیست و برای سرویس‌های غیرحسابی مناسب است.

<!--/seo-open-->

از این سرویس برای تولید توکن با رویکرد Client_Credential استفاده کنید. از آنجا که این سرویس به منابع (resource) خود کلاینت نیاز دارد، احتیاجی به دریافت اجازه دسترسی از کاربر بیرونی نخواهد بود.

Grant type: client_credentials

دانلود مستندات ریسپانس کدها — response-code-token-cc

POST /dev/v2/oauth2/token

Headers

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

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

مقدار AuthenticationString باید برابر Base64 از اطلاعات برنامه شما به صورت YOURCLIENTID:YOURCLIENTSECRET باشد. برای مثال اگر شناسه برنامه شما برابر firstapp باشد و رمز برنامه شما که در قسمت جزییات برنامه در کنسول قابل مشاهده است برابر 6932dddb927b76e54997 باشد، شما باید Base64 مقدار firstapp:6932dddb927b76e54997 را تولید کنید. در این صورت مقدار این هدر باید برابر مقدار زیر قرار گیرد:

Basic Zmlyc3RhcHA6NjkzMmRkZGI5MjdiNzZlNTQ5OTc=

Notes

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

برای بانک‌های پارسیان، تجارت و رفاه فیلدهای bank و additionalInfo لازم است.

post/dev/v2/oauth2/token

Request

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

Request body

grant_type'client_credentials' required

باید برابر client_credentials باشد

nidstring required

کد ملی ۱۰ رقمی فراخواننده که به کلاینت دسترسی دارد

scopesstring required

اسکوپ‌های درخواستی، با کاما از هم جدا می‌شوند

bankstring

کد بانک (برای برخی بانک‌ها الزامی)

Example request

{
  "nid": "0123456789",
  "scopes": "oak:deposit-to-iban:get",
  "bank": "054"
}

Response

توکن با موفقیت صادر شد

responseCodestring

کد پاسخ

status'DONE' | 'FAILED'

Changes

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