مستندات API استعلام اطلاعات هویتی (ثبت احوال ) با کد ملی

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

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

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

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

🏷️ CURL

📡 POST /api/v2/nid_inquiry

_curl --location --request POST 'https://shabanic.ir/api/v2/nid_inquiry' \
--header 'SHABANIC-API-KEY: {YOUR_SHABANIC_TOKEN}' \
--form 'nationalCode="{YOUR_nationalCode}"' \
--form 'birthDate="YOUR_birthDate"'

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

🗂️ JSON Inputs

_{
  "nationalCode": "0829940049",
  "birthDate": "1366/04/01"
}

📤 خروجی سرویس

🧾 JSON Response

{
  "success": true,
  "status": "DONE",
  "trackId": "shabanic-6a2870b196beb8.36913077",
  "result": {
    "deathStatus": "زنده",
    "firstName": "علی",
    "lastName": "رضایی",
    "base64BinanryImage": null,
    "gender": "مرد",
    "identitySerial": "482107",
    "identitySeri": "ا54",
    "nationalId": "0019940049",
    "birthDate": "1360/04/01",
    "fatherName": "رضا",
    "operationStatus": null,
    "identityNo": "23",
    "trackingCode": null,
    "officeName": "شيروان - تهران",
    "officeCode": "458"
  }
}

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

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

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

ورودی‌ها (Parameters)

  • nationalCode — کد ملی
  • birthDate — تاریخ تولد

خروجی‌ها (Response)

  • success — وضعیت کلی درخواست
  • trackId — ترک آی دی جهت پیگیری درخواست
  • deathStatus — وضعیت حیات
  • firstName — نام
  • lastName — نام خانوادگی
  • gender — سن
  • identitySerial — سریال شناسنامه
  • identitySeri — سری شناسنامه
  • nationalId — کد ملی
  • birthDate — تاریخ تولد
  • fatherName — نام پدر
  • identityNo — شماره شناسنامه
  • officeName — آدرس اداره ثبت احوال
  • officeCode — کد اداره ثبت احوال

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

  • احراز هویت —تکمیل خودکار فرم‌های ثبت‌نام کاربران (KYC)
  • امنیت بانکی —تطبیق اطلاعات هویتی برای صدور کارت و تسهیلات
  • خدمات بیمه‌ای —اعتبارسنجی دقیق مشخصات فردی در صدور بیمه‌نامه
  • سامانه‌های مالی —جلوگیری از ثبت‌نام با مشخصات جعلی یا افراد فوت‌شده
  • مدیریت پرسنلی —استعلام و تأیید مدارک هویتی در فرآیند استخدام
  • امور قضایی —تأیید اطلاعات شناسنامه‌ای در اسناد و قراردادهای رسمی
  • فروشگاه آنلاین —احراز هویت خریداران برای کالاهای حساس و قانونی
  • اتوماسیون اداری —یکپارچه‌سازی دیتای هویتی در زیرساخت‌های سازمانی
  • پلتفرم‌های معاملاتی —احراز هویت دو مرحله‌ای بر اساس کد ملی و تاریخ تولد

نکات مهم

  • فعال‌سازی 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)

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

این سرویس به صورت مستقیم به پایگاه داده رسمی سازمان ثبت احوال کشور متصل است و نتایج آن کاملاً رسمی، دقیق و قابل استناد می‌باشد.

بله، یکی از مزایای API استعلام هویت شبانیک، بازگرداندن جزئیات کامل شامل شماره شناسنامه، سری و سریال شناسنامه، و حتی کد اداره ثبت احوال صادرکننده است.

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

بله، در خروجی این سرویس، پارامتر deathStatus وجود دارد که وضعیت زنده یا فوت بودن فرد را به صورت آنی نمایش می‌دهد.

شبانیک مدل “پرداخت به ازای مصرف” را ارائه می‌دهد؛ یعنی شما نیاز به خرید اشتراک ماهیانه ندارید و تنها هزینه تراکنش‌های موفق خود را می‌پردازید.

این API برای استفاده در پروژه‌های Real-time بهینه‌سازی شده است و اطلاعات هویتی را در کمتر از چند ثانیه از دیتابیس مرجع واکشی کرده و باز می‌گرداند.

کافیست در سایت شبانیک پروفایل خود را تکمیل کرده و سپس با شماره 09156012679 تماس بگیرید تا مجوزهای لازم صادر و توکن اختصاصی برای شما فعال شود.

بله، به دلیل ارائه خروجی استاندارد JSON، این API به راحتی در تمامی زبان‌های برنامه‌نویسی موبایل مثل Kotlin، Java، Swift و Flutter قابل پیاده‌سازی است.

در صورت داشتن مجوزهای خاص و هماهنگی با پشتیبانی شبانیک، پارامتر مربوط به تصویر (base64BinanryImage) در خروجی برخی پکیج‌های پیشرفته فعال خواهد بود.

برای هر درخواست یک trackId اختصاصی تولید می‌شود. شما می‌توانید با ارائه این کد به تیم پشتیبانی شبانیک، وضعیت دقیق درخواست خود را در هر لحظه پیگیری کنید.

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

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

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