مستندات API استعلام شاهکار (تطبیق کد ملی با موبایل)

مستندات API استعلام شاهکار (تطبیق کد ملی با موبایل) | راهنمای کامل استفاده

در این صفحه می‌توانید راهنمای کامل استفاده از API استعلام شاهکار (تطبیق کد ملی با موبایل) را مشاهده کنید. شامل پارامترهای ورودی، نمونه درخواست CURL، خروجی پاسخ، کدهای آماده و ویدئوی آموزشی برای درک بهتر عملکرد سرویس و استفاده آسان در پروژه‌های خود است. این مستندات به شما کمک می‌کند تا API را به‌صورت دقیق و سریع پیاده‌سازی کنید و از تمام قابلیت‌های سرویس بهره‌مند شوید.

📝 توضیحات سرویس

با این سرویس می‌توانید تنها با وارد کردن کد ملی و شماره موبایل، از تطابق مالک خط تلفن همراه با صاحب کد ملی اطمینان حاصل کنید. این استعلام به‌صورت تکی و لحظه‌ای انجام می‌شود و برای احراز هویت کاربران در ثبت‌نام‌ها، خدمات آنلاین و فرآیندهای بانکی کاربرد دارد.

🏷️ CURL

📡 POST /api/v2/shahkar

curl --location 'https://shabanic.ir/api/v2/shahkar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_SHABANIC_TOKEN}' \
--data '{
  "national_code": "{YOUR_NATIONAL_CODE}",
  "mobile": "{YOUR_MOBILE}"
}'

📌 ورودی های سرویس

🗂️ JSON Inputs

{
    "mobile": "{YOUR_MOBILE}",
    "national_code": "{YOUR_NATIONAL_CODE}"
}

📤 خروجی سرویس

🧾 JSON Response

{
    "result": {
        "isMatched": true
    },
    "status": "DONE",
    "success": true,
    "trackId": "shabanic-699dd1829095b4.56546782"
}

{
	"success": false,
	"error_code": "FN-BRFH-50000040816",
	"message": "پیغام مرتبط با خطا",
	"trackId": "shabanic-699dcc859daf40.50355751"
}
برای پیگیری خطا کافیست مقدار trackId را به پشتیبانی شبانیک بدهید.

ℹ️ توضیحات سرویس استعلام شاهکار (تطبیق کد ملی با موبایل)

این سرویس برای استعلام شاهکار (تطبیق کد ملی با موبایل) استفاده می‌شود. در ادامه مشخصات کامل درخواست و پاسخ را مشاهده می‌کنید.

ورودی‌ها (Parameters)

  • mobile — شماره موبایل کاربر (فرمت: 09xxxxxxxxx)
  • nationalCode — کد ملی کاربر (10 رقم)

خروجی‌ها (Response)

  • isMatched — اگر برابر با true باشد انطباق مالکیت و در غیر اینصورت عدم انطباق مالکیت

کاربرد های این Api

  • استعلام شاهکار —تطبیق کد ملی با شماره موبایل
  • اعتبارسنجی حساب بانکی —بررسی صحت شماره کارت و شبا
  • تطبیق اطلاعات هویتی —اطمینان از مطابقت داده‌های شخصی کاربران
  • یکپارچه‌سازی با سیستم‌ها —استفاده در اپلیکیشن‌ها و وب‌سرویس‌ها
  • کاهش خطای انسانی —خودکارسازی بررسی اطلاعات برای سرعت و دقت بیشتر

نکات مهم

  • فعال‌سازی API شبانیک — برای شروع استفاده از APIهای شبانیک، ابتدا پروفایل خود را تکمیل کنید (مشاهده پروفایل) و سپس با پشتیبانی مستقیم شبانیک (09156012679) برای صدور مجوز و دریافت توکن اقدام نمایید.
  • توکن شبانیک — پس از دریافت مجوز، توکن خود را به‌عنوان Bearer در هدر درخواست‌ها قرار دهید.

🎬 ویدئوی آموزشی API استعلام شاهکار (تطبیق کد ملی با موبایل)

در این ویدئو نحوه فراخوانی API استعلام شاهکار (تطبیق کد ملی با موبایل) از سامانه شبانیک توضیح داده شده است.

💻 دانلود نمونه کدهای API استعلام شاهکار (تطبیق کد ملی با موبایل)

در این بخش می‌توانید نمونه کدهای آماده برای فراخوانی API استعلام شاهکار (تطبیق کد ملی با موبایل) شبانیک به زبان‌های PHP (Laravel)، JavaScript (Node.js)، Python، Java، Kotlin، C# (.NET) و cURL را دانلود کرده و مستقیماً در پروژه خود استفاده کنید.

نمونه کد PHP (Laravel) برای فراخوانی API استعلام شاهکار (تطبیق کد ملی با موبایل)

دانلود فایل PHP

نمونه کد JavaScript (Node.js) برای استفاده از API استعلام شاهکار (تطبیق کد ملی با موبایل)

دانلود فایل JavaScript

نمونه کد Python برای اتصال به API استعلام شاهکار (تطبیق کد ملی با موبایل) شبانیک

دانلود فایل Python

نمونه کد Java (اندروید) برای فراخوانی API استعلام شاهکار (تطبیق کد ملی با موبایل)

دانلود فایل Java

نمونه کد Kotlin برای استفاده از API استعلام شاهکار (تطبیق کد ملی با موبایل) در اپلیکیشن موبایل

دانلود فایل Kotlin

نمونه کد C# (.NET) برای اتصال به API استعلام شاهکار (تطبیق کد ملی با موبایل)

دانلود فایل C#

نمونه درخواست cURL برای تست API استعلام شاهکار (تطبیق کد ملی با موبایل)

دانلود فایل cURL
دانلود همه نمونه کدهای API این سرویس به صورت (ZIP)

❓ سوالات متداول (FAQ)

پاسخ به سوالات رایج در استفاده از سرویس استعلام شاهکار (تطبیق کد ملی با موبایل).

این سرویس با دریافت کد ملی و شماره موبایل، بررسی می‌کند که مالک خط تلفن همراه همان شخص صاحب کد ملی است یا خیر. برای احراز هویت کاربران در ثبت‌نام‌ها، خدمات آنلاین و فرآیندهای بانکی کاربرد دارد.

شما باید کد ملی (nationalCode) و شماره موبایل (mobile) را به فرمت JSON ارسال کنید. شماره موبایل باید با 09 شروع شود و کد ملی 10 رقمی باشد.

خروجی شامل فیلد isMatched است. اگر مقدار آن true باشد، مالکیت موبایل و کد ملی تطابق دارد، در غیر اینصورت false خواهد بود. همچنین وضعیت موفقیت درخواست و یک trackId برای پیگیری بازگردانده می‌شود.

توکن شبانیک را از سامانه شبانیک دریافت کرده و به هدر درخواست خود به صورت Bearer Token اضافه کنید. بدون این توکن، درخواست شما رد خواهد شد.

بله، شبانیک نمونه کدهای آماده به زبان‌های PHP (Laravel)، JavaScript، Python، Java، Kotlin، C# و cURL ارائه کرده است. همچنین ویدئوی آموزشی نحوه فراخوانی API برای درک بهتر عملکرد سرویس در دسترس است.

✅ برنامه‌های بانکی و مالی اپلیکیشن‌های بانک‌ها، موسسات مالی و سرویس‌های پرداخت آنلاین هنگام افتتاح حساب، تراکنش، یا دادن تسهیلات نیاز دارند تا مطمئن شوند اطلاعات واردشده از سوی کاربر واقعی و متعلق به همان شخص است. API تطبیق کد ملی با موبایل به این احراز هویت کمک می‌کند. ✅ اپلیکیشن‌های خدمات آنلاین و ثبت‌نام کاربران هر سایت یا اپلیکیشنی که دارای فرم ثبت‌نام است — مثل مارکت‌پلیس‌ها، سامانه‌های خدماتی، اپ‌های رزرو، مدیریت، خرید آنلاین، و پنل‌های کاربری — می‌توانند از این API برای جلوگیری از ثبت‌نام‌های جعلی استفاده کنند. ✅ کسب‌وکارهای بیمه و فین‌تک شرکت‌های بیمه، استارتاپ‌های فین‌تک و پلتفرم‌های پرداخت اعتباری با اتصال به API استعلام شاهکار می‌توانند احراز هویت سریع و دقیق داشته باشند و از تقلب‌های هویتی جلوگیری کنند. ✅ سرویس‌های دولتی و اداری آنلاین سامانه‌های دولتی یا پروژه‌هایی که ثبت‌نام آنلاین را مدیریت می‌کنند (مثل سایت‌های خدمات الکترونیکی، سامانه‌های نوبت‌دهی، یا فرم‌های رسمی) از این API برای مطابقت شماره موبایل با کد ملی استفاده می‌کنند تا هویت کاربر را تایید کنند. ✅ اپ‌های پرداخت موبایلی و کیف پول دیجیتال نرم‌افزارهایی مثل اپلیکیشن‌های پرداخت موبایلی (برای مثال نسخه‌ای از خدمات بانک‌ها مثل «صاپ» در ایران که از شاهکار برای تطبیق اطلاعات استفاده می‌کنند) نیز از این نوع استعلام برای افزایش امنیت تراکنش‌های کاربران بهره می‌برند. 📌 خلاصه اینکه این API به‌ویژه در بیزینس‌هایی که به احراز هویت کاربران، جلوگیری از تقلب، امنیت بالا، و صحت اطلاعات نیاز دارند کاربرد دارد — از بانک‌ها و پرداخت‌های آنلاین تا پلتفرم‌های ثبت‌نام و خدمات دیجیتال.

آماده‌اید به ساده‌ترین شکل ممکن، API «استعلام شاهکار (تطبیق کد ملی با موبایل)» را از شبانیک دریافت کنید؟

تنها در چند مرحله ساده، کلید اختصاصی API خود را دریافت کرده و سرویس استعلام شاهکار (تطبیق کد ملی با موبایل) را در پروژه خود فعال کنید.

رفتن به پنل توسعه‌دهندگان
Shabanic Postman