مستندات API استعلام وضعیت حیات - زنده بودن
مستندات API استعلام وضعیت حیات - زنده بودن | راهنمای کامل استفاده
در این صفحه میتوانید راهنمای کامل استفاده از API استعلام وضعیت حیات - زنده بودن را مشاهده کنید. شامل پارامترهای ورودی، نمونه درخواست CURL، خروجی پاسخ، کدهای آماده و ویدئوی آموزشی برای درک بهتر عملکرد سرویس و استفاده آسان در پروژههای خود است. این مستندات به شما کمک میکند تا API را بهصورت دقیق و سریع پیادهسازی کنید و از تمام قابلیتهای سرویس بهرهمند شوید.
📝 توضیحات سرویس
وبسرویس استعلام وضعیت حیات و فوت شبانیک، ابزاری دقیق و سریع برای تایید وضعیت زنده یا فوت بودن افراد بهصورت مستقیم از پایگاه داده رسمی ثبت احوال است. با بهرهگیری از این API، توسعهدهندگان و کسبوکارها میتوانند تنها با ارسال کد ملی و مشخصات فردی، در لحظه از صحت وضعیت حیات اشخاص اطمینان حاصل کنند. این سرویس با تضمین دقت دادهها و فرآیند اتصال آنی، راهکاری مطمئن و مقرونبهصرفه برای ارتقای فرآیندهای احراز هویت در سیستمهای مالی، حقوقی و اداری فراهم میکند که بدون نیاز به حق اشتراک ماهیانه، به سادهترین شکل ممکن قابل پیادهسازی است.
🏷️ CURL
📡 POST /api/v2/health_check
curl --location --request POST 'https://shabanic.ir/api/v2/health_check' \
--header 'SHABANIC-API-KEY: {YOUR_SHABANIC_TOKEN}' \
--form 'birthDate="{YOURE_BIRTHDATE}"' \
--form 'nationalCode="{YOURE_NATIONALCODE}"' 📌 ورودی های سرویس
🗂️ JSON Inputs
{
'birthDate="{YOURE_BIRTHDATE}"',
'nationalCode="{YOURE_NATIONALCODE}"'
}📤 خروجی سرویس
🧾 JSON Response
{
"success": true,
"status": "DONE",
"trackId": "shabanic-6a2acdbc74ed01.32120205",
"result": {
"deathStatus": "زنده"
}
}
{
"success": false,
"error_code": "FN-BRFH-50000040816",
"message": "پیغام مرتبط با خطا",
"trackId": "shabanic-699dcc859daf40.50355751"
}
ℹ️ توضیحات سرویس استعلام وضعیت حیات - زنده بودن
این سرویس برای استعلام وضعیت حیات - زنده بودن استفاده میشود. در ادامه مشخصات کامل درخواست و پاسخ را مشاهده میکنید.
ورودیها (Parameters)
- birthDate — تاریخ تولد
- nationalCode — کد ملی
خروجیها (Response)
- success — وضعیت درخواست
- trackId — شناسه پیگیری
- deathStatus — وضعیت حیات فرد ( زنده / مرده )
کاربرد های این Api
- امنیت تراکنش —جلوگیری از جعل هویت در سامانههای مالی
- اعتبارسنجی سریع —اعتبارسنجی آنی کاربران در فرایند ثبتنام
- مدیریت مستمری —کنترل خودکار وضعیت حیات برای پرداخت حقوق
- خدمات بیمهای —استعلام زنده بودن در پروندههای خدمات بیمه
- امور حقوقی —بررسی دقیق وضعیت حیات در اسناد قضایی
- قرارداد الکترونیک —احراز هویت طرفین در قراردادهای دیجیتال
- تسهیلات بانکی —تأیید وضعیت حیات برای افتتاح حساب و وام
- راستیآزمایی داده —صحتسنجی اطلاعات هویتی مشتریان بانک
- اتوماسیون اداری —یکپارچهسازی هوشمند سامانهها با 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❓ سوالات متداول (FAQ)
پاسخ به سوالات رایج در استفاده از سرویس استعلام وضعیت حیات - زنده بودن.
این سرویس به صورت مستقیم و آنی به پایگاه داده رسمی ثبت احوال متصل است؛ به همین دلیل اطلاعات ارائه شده توسط API شبانیک دارای بالاترین دقت و اعتبار قانونی برای کسبوکارها میباشد.
شما تنها با داشتن «کد ملی» و «تاریخ تولد» فرد مورد نظر، میتوانید از طریق وبسرویس شبانیک در لحظه از وضعیت زنده یا فوت بودن شخص اطمینان حاصل کنید.
خیر، یکی از مزایای شبانیک مدل پرداخت به ازای مصرف است. شما بدون نیاز به هزینههای سنگین اشتراک، تنها بابت هر استعلام موفق هزینه پرداخت میکنید که بسیار مقرونبهصرفه است.
با توجه به زیرساختهای بهینه شبانیک، فرایند استعلام وضعیت حیات در کمتر از چند ثانیه انجام شده و پاسخ به صورت یکپارچه برای سامانه یا اپلیکیشن شما ارسال میگردد.
کافیست در پنل شبانیک ثبتنام کرده و پروفایل خود را تکمیل کنید. سپس از طریق تماس با پشتیبانی (09156012679) مجوز دسترسی صادر شده و توکن اختصاصی در اختیار شما قرار میگیرد.
خروجی این API به صورت استاندارد JSON بوده و وضعیت نهایی فرد را با دو مقدار «زنده» یا «فوت شده» برمیگرداند که به سادگی در تمام سیستمهای نرمافزاری قابل پردازش است.
تمامی درخواستها در بستر امن و پروتکل HTTPS تبادل میشوند. همچنین دسترسی به دیتای حساس تنها با توکنهای رمزنگاری شده امکانپذیر است تا امنیت کامل اطلاعات کاربران حفظ شود.
بله، شبانیک برای راحتی توسعهدهندگان، نمونه کدهای آماده به زبانهای PHP، Python، Node.js، C# و… را ارائه داده است که در همین صفحه قابل دانلود و استفاده میباشد.
این API برای صندوقهای بازنشستگی جهت تایید حقوق مستمریبگیران، بانکها برای افتتاح حساب، دفاتر حقوقی و پلتفرمهای احراز هویت آنلاین بسیار کاربردی و ضروری است.
تیم فنی شبانیک از طریق شماره تماس مستقیم و تیکت پشتیبانی در تمام روزهای هفته آماده پاسخگویی و رفع مشکلات احتمالی شما در پیادهسازی API است.
آمادهاید به سادهترین شکل ممکن، API «استعلام وضعیت حیات - زنده بودن» را از شبانیک دریافت کنید؟
تنها در چند مرحله ساده، کلید اختصاصی API خود را دریافت کرده و سرویس استعلام وضعیت حیات - زنده بودن را در پروژه خود فعال کنید.