سرویس های احراز هویت

احراز هویت با کد ملی با پیامک

<!--seo-open-->

سرویس «احراز هویت با کد ملی با پیامک» (National ID / KYC / SMS/OTP) در دسته احراز هویت و شناخت مشتری فینوتک؛ نسخه پیامکی برای فراخوانی با تایید کاربر. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی با تایید پیامکی کاربر (authorization_sms) انجام می‌شود. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

احراز هویت با کد ملی؛ این سرویس کد ملی، تاریخ تولد و نام را دریافت می‌کند و شباهت نام ارسال‌شده را با نام واقعی صاحب کد ملی برمی‌گرداند.

Scope: facility:sms-nid-verification:get<br />

Grant type: authorization_sms

نکته: پارامترهای query باید encode شده ارسال شوند. حداقل یکی از fullName، firstName، lastName یا gender برای مشاهده شباهت ارسال شود.

get/facility/v2/clients/{clientId}/users/{nid}/sms/nidVerification

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/facility/v2/clients/{clientId}/users/{nid}/sms/nidVerification
  • Auth: HTTP bearer

Path parameters

clientIdstring required
nidstring required

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

Query parameters

trackIdstring
birthDatestring required

تاریخ تولد به صورت yyyy/mm/dd

fullNamestring

نام کامل

firstNamestring

نام

lastNamestring

نام خانوادگی

fatherNamestring

نام پدر

gender'زن' | 'مرد'

جنسیت — زن یا مرد

Response

Successful response

responseCodestring

کد پاسخ دریافتی

trackIdstring

کد پیگیری

statusstring

وضعیت فراخوانی — DONE یا FAILED

Example response

{
  "responseCode": "FN-FYKZ-20000400000",
  "trackId": "nid-inq-9602281200",
  "status": "DONE",
  "result": {
    "nationalCode": "0067408595",
    "birthDate": "1365/11/25",
    "status": "DONE",
    "fullName": "سعید غلامی فرد",
    "fullNameSimilarity": 100,
    "firstName": "سعید",
    "firstNameSimilarity": 100,
    "lastName": "غلامی فرد",
    "lastNameSimilarity": 100,
    "fatherName": "علی",
    "fatherNameSimilarity": 100,
    "deathStatus": "زنده",
    "gender": "مرد",
    "genderSimilarity": 100,
    "trackingCode": "123456"
  }
}

Changes

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