این وب سرویس کد ملی و شماره شبا افراد را براساس اطلاعات ثبت شده بررسی و صحت آنها را تأیید میکند
تجربهای بینظیر داشته باشید!ما در شبانیک تمامی سرویس ها را در قالب API با ارزانترین تعرفه ممکن و بدون حق اشتراک ماهیانه تقدیمتان میکنیم.
تماشای ویدئوی آموزشی کوتاه درباره تطبیق شماره شبا و کدملی در قالب API را از دست ندهید.
راهنمای متنی دریافت تطبیق شماره شبا و کدملی در قالب API را در این بخش به صورت مرحله به مرحله و دقیق مطالعه کنید.
در این بخش میتوانید نمونهکدهای تطبیق شماره شبا و کدملی در قالب API را برای زبانهای مختلف دانلود کنید.
پس از مشاهده ویدئوی کوتاه زیر به راحتی میتوانید از شبانیک تطبیق شماره شبا و کدملی در قالب API را اخذ نمایید و شماره شبا را با کد ملی تطابق دهید.
اگر امکان مشاهده ویدئوی بالا را ندارید، میتوانید بهراحتی با دنبال کردن مراحل زیر، تطبیق شماره شبا و کدملی در قالب API را از شبانیک دریافت کنید.
برای بهرهمندی از سرویسهای متنوع و کاربردی شبانیک از طریق بستر API، لازم است ابتدا یک حساب کاربری فعال در سامانه شبانیک ایجاد نمایید. این فرایند بهسادگی و تنها با استفاده از شماره تلفن همراه یا ایمیل معتبر انجام میشود. ثبتنام اولیه، امکان دسترسی ایمن، سریع و ساختارمند به APIهای مختلف شبانیک را فراهم میسازد؛ از جمله خدمات استعلام، گزارشگیری، پردازش داده و اتصال به زیرساختهای هوشمند. با ایجاد حساب کاربری، علاوه بر تجربهای روان و قابل اطمینان، میتوانید از مستندات فنی دقیق، نمونه کدها و پشتیبانی حرفهای نیز بهرهمند شوید. بنابراین، برای شروع استفاده از خدمات تحت وب شبانیک و اتصال آسان به APIها، از اینجا میتوانید وارد شوید.
پس از ثبتنام در سامانه شبانیک و ورود به حساب کاربری، برای دسترسی کامل به امکانات فنی و سرویسهای API، کافی است از طریق پنل کاربری خود به بخش "منوی توسعهدهندگان" مراجعه کنید. این بخش مخصوص برنامهنویسان، توسعهدهندگان بکاند و کسبوکارهایی طراحی شده است که قصد دارند خدمات شبانیک را به صورت مستقیم در سیستمها و اپلیکیشنهای خود یکپارچهسازی کنند. در منوی توسعهدهندگان میتوانید به مستندات فنی کامل، کلیدهای API، سطح دسترسیها، تنظیمات امنیتی و نمونه کدهای آماده دسترسی داشته باشید. این قابلیت، فرآیند اتصال به سرویسهای مختلف مانند استعلامهای بانکی، خلافی خودرو، اطلاعات حساب و بسیاری دیگر را ساده و سریع میسازد. بنابراین اگر به دنبال یک راهکار پایدار، امن و حرفهای برای اتصال به APIهای شبانیک هستید، حتماً بازدید از منوی توسعهدهندگان را در اولویت قرار دهید.
پس از ورود به پنل کاربری شبانیک، برای شروع استفاده از سرویسهای قدرتمند API، ابتدا سرویس مورد نظر خود را از لیست موجود انتخاب نمایید. در ادامه، در بخش مربوط به آیپیهای مجاز (Authorized IPs)، آدرس آیپیهایی را وارد کنید که مایل هستید تنها از طریق آنها به این سرویس API دسترسی داده شود؛ این آیپیها معمولاً شامل سرور بکاند شما خواهند بود. اگرچه امکان ارسال درخواست مستقیم از سمت کلاینت نیز وجود دارد، اما توصیه جدی شبانیک استفاده از بکاند اپلیکیشن برای ارسال ریکوئستهاست تا حداکثر امنیت در تبادل اطلاعات و حفاظت از توکن امنیتی شما برقرار باشد. لطفاً توجه داشته باشید که برای وارد کردن چند آیپی، لازم است آنها را با علامت آندرلاین (_) از یکدیگر جدا نمایید. چنانچه این فیلد را خالی بگذارید، شبانیک تمامی درخواستهایی که با توکن امنیتی معتبر به سمت API ارسال میشوند را پاسخ خواهد داد. پس از تکمیل اطلاعات، روی دکمه ثبت کلیک نمایید. در بخش پایین صفحه، جدولی شامل لیست سرویسهای API که تاکنون فعال کردهاید نمایش داده میشود. حالا کافیست توکن امنیتی اختصاصی مربوط به سرویس را کپی کرده و طبق راهنمای موجود در ادامه همین آموزش، آن را در برنامه یا سرور خود پیادهسازی کنید. همچنین، در مرحلهی سوم و با توجه به تصویر راهنما، میتوانید بهراحتی کلید API مربوط به سرویس انتخابی را دریافت کرده و از آن در توسعه نرمافزار، سامانه یا اپلیکیشن خود استفاده نمایید. با رعایت این مراحل ساده و دقیق، میتوانید به شکلی سریع، امن و مستند شده از APIهای حرفهای شبانیک بهرهمند شوید.
برای تست API تطبیق شماره شبا و کدملی از سامانه شبانیک در نرم افزار postman کافیست مراحل زیر را انجام دهید.
"https://shabanic.ir/api/v1/ibanOwnerVerification?nid=0829940049&iban=IR880190000000334341732005"
گرچه با ایجاد درخواست و تعریف Url مرحله قبل پارامتر های account_number و bank_code به صورت خودکار ایجاد می شوند اما در نظر داشته باشید باید طبق راهنمایی تصویر زیر باید پارامترهای ذکر شده را در بخش Params نرم افزار postman وجود داشته باشند
nid=0829940049
iban=IR880190000000334341732005
- nid : کد ملی
- iban : شماره شبا
- برای گرفتن پاسخ از هر سرویس شبانیک در بستر API باید از پنل کاربری خود در شبانیک و از منوی توسعه دهندگان-درخواست Api نسبت به ثبت درخواست API و گرفتن توکن امنیتی اقدام نمایید، سپس طبق تصویر زیر در سربرگ Headers یک کلید به نام SHABANIC-API-KEY ایجاد نمایید و توکن امنیتی که از شبانیک گرفته اید را در این متغییر کپی نمایید
SHABANIC-API-KEY
- پس از تعریف متغیر توکن امنیتی در Postman، بر روی گزینه Send کلیک کنید تا نتیجه استعلام سرویس برای شما نمایش داده شود. بسته به سرویسی که در حال دریافت API آن از شبانیک هستید، پاسخ متفاوتی دریافت خواهید کرد. به عنوان مثال، در این سرویس که مربوط به تطبیق شماره شبا و کدملی تمامی بانک های کشور ایران است، پاسخ API شبانیک به صورت رشتهای از نوع JSON مطابق نمونه زیر ارائه میشود.
{
"responseCode": "FN-KCFH-20002800000",
"trackId": "iovTrackId",
"result": {
"isValid": "yes"
},
"status": "DONE"
}
- در رشته JSON برگشت داده شده مشخصات و اطلاعات شماره شبا برگشت داده می شود.
- isValid : اگر مقدار برگشتی این متغییر برابر با yes باشد به این مفهوم است که کد ملی با شماره شبا انططباق دارد و اگر no باشد یعنی کد ملی با شماره شبا انطباق ندارد.
- status : اگر این
متغییر برابر با DONE باشد وضعیت استعلام بدون خطا و اگر برابر
با FAILED باشد یعنی استعلام با خطا مواجه شده است..
در این بخش میتوانید نمونهکدهای دریافت تطبیق شماره شبا و کدملی از شبانیک را به زبانهای مختلف و پرکاربرد دانلود کنید.
تنها در چند مرحله به راحتی از شبانیک API دلخواه خود را بگیرید
شبانیک با افتخار امکان دسترسی به خدمات خود را از طریق API برای توسعهدهندگان فراهم کرده است. در ادامه میتوانید فهرست سرویسهای قابل استفاده را مشاهده کنید. در صورت نیاز به راهنمایی بیشتر پس از مطالعه مستندات، لطفاً با پشتیبانی ۲۴ ساعته شبانیک از طریق شماره ۰۹۱۵۶۰۱۲۶۷۹ تماس بگیرید.
این لیست در حال تکمیل است و تمامی سرویسهای شبانیک قابلیت ارائه بهصورت API را دارند. اگر سرویسی مورد نیازتان است اما در لیست نیست، با پشتیبانی شبانیک (09156012679) در میان بگذارید.