فعال نسخه ۱.۰.۲

تطبیق کد ملی و موبایل

این سرویس به شما امکان می‌دهد تا مالکیت شماره موبایل ارائه شده را با کد ملی وارد شده تطبیق دهید. این فرآیند بر اساس داده‌های رسمی سامانه "شاهکار" انجام شده و برای احراز هویت کاربران در سامانه‌های بانکی و پلتفرم‌های حساس بسیار ضروری است.

نمونه درخواست JSON

{
  "nationalCode": "0012345678",
  "mobile": "09123456789",
  "trackId": "d7b9c2e0-f3a1-4e2b-8c7a-9d8f6e5a4b3c"
}

پاسخ موفق (200 OK)

{
  "success": true,
  "data": {
    "matched": true,
    "message": "کد ملی و موبایل مطابقت دارند",
    "timestamp": "2023-10-25T14:30:00Z"
  },
  "trackId": "d7b9c2e0-f3a1-4e2b-8c7a-9d8f6e5a4b3c"
}

خطاهای احتمالی

{
  "success": false,
  "error": {
    "code": "INVALID_NATIONAL_CODE",
    "message": "ساختار کد ملی وارد شده صحیح نیست"
  }
}

link آدرس فراخوانی (Endpoint)

POST https://api.api360.ir/v1/identity/match

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

کلید	مقدار	توضیحات
Authorization	Bearer {API_KEY}	کلید اختصاصی دسترسی به سرویس
Content-Type	application/json	فرمت داده‌های ارسالی

پارامترهای ورودی (Body)

پارامتر	نوع	الزامی	توضیحات
nationalCode	String (10)	بله	کد ملی ۱۰ رقمی بدون خط تیره
mobile	String (11)	بله	شماره موبایل با فرمت 09xxxxxxxxx
trackId	String (UUID)	خیر	شناسه یکتای درخواست (اختیاری)

۴,۹۰۰ ریال

تعرفه سرویس

هزینه به ازای هر فراخوانی موفق