سرویس API نوین وان

API شاهکار؛ تطبیق آنی کد ملی با شماره موبایل برای احراز هویت امن کسب‌وکارها

معماری استاندارد REST که با هر زبان برنامه‌نویسی و فریم‌ورکی سازگار است و امکان فراخوانی هم‌زمان از چند سرویس داخلی شما (پنل ثبت‌نام، سامانه KYC، درگاه پرداخت) را بدون تغییر در معماری فراهم می‌کند.

  • تطبیق کد ملی با شماره موبایل (شاهکار)
  • وب سرویس مناسب فین‌تک، پرداخت‌یار و سامانه‌های KYC
  • API احراز هویت مالکیت سیم‌کارت
  • خروجی ساده و قابل استفاده مستقیم در فرآیندهای ثبت‌نام و onboarding
پاسخ سرویس 200 OK
{
  "success": true,
  "data": {
    "matched": true
  }
}
application/jsonNovin One API

REST APIمعماری استاندارد REST که با هر زبان برنامه‌نویسی و فریم‌ورکی سازگار است و امکان فراخوانی هم‌زمان از چند سرویس داخلی شما (پنل ثبت‌نام، سامانه KYC، درگاه پرداخت) را بدون تغییر در معماری فراهم می‌کند.

JSONپاسخ سرویس شاهکار به‌صورت JSON ساختاریافته و با فیلد صریح نتیجه تطبیق (isMatched) بازمی‌گردد تا تیم فنی شما بدون پردازش اضافه، مستقیم از خروجی در فرآیند خود استفاده کند.

HTTPSانتقال کد ملی و شماره موبایل در تمام مراحل از مسیر HTTPS و با رمزنگاری TLS انجام می‌شود تا داده‌های حساس کاربران در مسیر انتقال کاملاً محافظت شوند.

پشتیبانی فنیدر مراحل اتصال، تست در محیط Sandbox و رفع خطاهای احتمالی در فراخوانی، تیم فنی نوین وان همراه توسعه‌دهندگان شماست.

قیمت گذاری

قیمت API شاهکار

هزینه استفاده از این API بسته به حجم استعلام ماهانه و نوع کسب‌وکار شما به‌صورت اختصاصی و مذاکره‌ای تعیین می‌شود. به‌جای پلن‌های از‌پیش‌تعیین‌شده، برای دریافت پیش‌فاکتور متناسب با مقیاس واقعی تراکنش‌هایتان کافی است از پنل کسب‌وکار یک تیکت برای بخش مالی ثبت کنید و حجم تقریبی استعلام‌های ماهانه را اعلام نمایید تا کارشناسان تجاری با شما هماهنگ شوند.

برای اتصال سریع تر

کاربردهای API شاهکار برای کسب‌وکارها

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

01

احراز هویت و KYC در ثبت‌نام آنلاین

در مراحل onboarding، با ارسال کد ملی و شماره موبایل اعلامی کاربر، مالکیت خط به‌صورت رسمی تأیید می‌شود تا از ثبت حساب با سیم‌کارت دیگران جلوگیری گردد.

02

جلوگیری از سوءاستفاده و تقلب

پیش از فعال‌سازی حساب، تغییر اطلاعات حساس یا انجام تراکنش‌های مهم، تطبیق شاهکار انجام می‌شود تا ریسک جعل هویت و سوءاستفاده به حداقل برسد.

03

تکمیل و اعتبارسنجی اطلاعات تماس کاربر

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

برای تیم های محصول

صنایعی که از API شاهکار نوین وان استفاده می‌کنند

هر کسب‌وکاری که در فرآیند ثبت‌نام، احراز هویت یا ارائه خدمات حساس به تأیید مالکیت سیم‌کارت نیاز دارد، می‌تواند این استعلام را در دل سیستم خود و بدون دخالت کاربر انجام دهد.

گفتگو با تیم فروش

فین‌تک و کیف‌پول‌های دیجیتال

پیش از فعال‌سازی حساب یا روش برداشت، مالکیت شماره موبایل کاربر با کد ملی او از طریق شاهکار تأیید می‌شود.

درگاه‌های پرداخت و پرداخت‌یارها

در فرآیند احراز هویت پذیرنده یا کاربر نهایی، تطبیق کد ملی و موبایل به‌صورت آنی انجام می‌گیرد.

شرکت‌های بیمه، لندتک و فروش اقساطی

پیش از صدور بیمه‌نامه یا اعطای تسهیلات، اطمینان از تعلق واقعی شماره تماس به متقاضی حاصل می‌شود.

تیم‌های محصول و سامانه‌های ثبت‌نام آنلاین

تأیید خودکار مالکیت موبایل کاربر بدون نیاز به کد تأیید پیامکی اضافی یا فرآیندهای دستی.

چگونه API شاهکار را پیاده‌سازی کنیم؟

راهنمای اتصال به API شاهکار

مستندات کامل به همراه نمونه کد و پاسخ استاندارد در اختیار تیم فنی شما قرار می‌گیرد تا اولین درخواست تطبیق را در کمترین زمان ممکن ارسال کنید.

  1. 01در پنل سازمانی نوین وان ثبت‌نام کنید و اطلاعات کاربری خود را با اطلاعات شرکت تکمیل کنید.
  2. 02پس از تأیید حساب کاربری، از پنل کاربری کلید دسترسی (API Key) و توکن احراز هویت را دریافت کنید.
  3. 03با مراجعه به مستندات، endpoint شاهکار را به محصول یا سامانه خود متصل کنید.
cURLPOST
curl --request GET 'https://api.novin.one/v1/verifyMobile?mobile=09901234123&nationalCode=0123456789' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
نمونه درخواست
اتصال قابل اعتماد

امنیت و پایداری اتصال API شاهکار

مدیریت توکن دسترسی، پایش مصرف و دسترسی همیشگی به مستندات، اتصال API شما را حتی در فراخوانی‌های حساس به داده‌های هویتی پایدار و امن نگه می‌دارد.

  • 01
    ارتباط رمزگذاری شدهدرخواست‌های حاوی کد ملی و شماره موبایل از مسیر HTTPS امن عبور می‌کنند.
  • 02
    دسترسی مبتنی بر توکنهر درخواست تطبیق نیازمند احراز هویت معتبر با API Key اختصاصی کسب‌وکار شماست.
  • 03
    کنترل مصرفگزارش تعداد استعلام‌های انجام‌شده و هزینه‌های مربوطه برای شما در پنل کسب‌وکار قابل پیگیری است.
چرا نوین وان

چرا کسب‌وکارها API شاهکار نوین وان را انتخاب می‌کنند؟

نوین وان علاوه بر ارائه وب‌سرویس‌های استعلامی، زیرساختی برای اتصال سریع، پایدار و قابل توسعه در اختیار کسب‌وکارها قرار می‌دهد.

01

+5

سال تجربه کاری

02

76

مشتری فین‌تک بزرگ

03

+30

سرویس فعال

04

زمان پاسخ‌دهی کمتر از

۱ تا ۳ ثانیه

05

+20

منبع اصلی و بدون واسط

06

امکان سفارشی‌سازی سرویس

چند استعلام همزمان

سوالات متداول

سوالات متداول درباره API شاهکار

آیا این سرویس برای استفاده مستقیم کاربران نهایی هم در دسترس است؟
خیر. این API صرفاً برای مصرف توسط سیستم‌های نرم‌افزاری کسب‌وکارهاست. کاربرانی که به‌صورت مقطعی نیاز به استعلام دارند، باید به نوین وان مراجعه کنند.
خروجی سرویس شاهکار چیست؟
نتیجه تطبیق به‌صورت فیلد matched (true یا false) بازگردانده می‌شود که نشان‌دهنده تعلق یا عدم تعلق شماره موبایل به صاحب کد ملی است.
آیا استفاده از این سرویس رایگان است؟
خیر. هزینه این سرویس بر اساس حجم تراکنش و به‌صورت مذاکره‌ای تعیین می‌شود. جزئیات نهایی از طریق ثبت تیکت با بخش مالی مشخص می‌شود.
در صورت عدم تطابق یا نامعتبر بودن اطلاعات، آیا هزینه‌ای کسر می‌شود؟
بله. هر فراخوانی موفق سرویس، فارغ از نتیجه تطبیق، مشمول کارمزد است، چون اتصال به منبع رسمی داده انجام شده است.
آیا داده‌ها مستقیماً از سامانه رسمی شاهکار دریافت می‌شود؟
بله. اطلاعات از منابع رسمی سامانه شاهکار (سازمان تنظیم مقررات و ارتباطات رادیویی) استخراج و تحویل داده می‌شود.
برای اتصال آماده اید؟

مسیر API محصولتان را از امروز یکپارچه کنید.

حساب سازمانی خود را بسازید و سرویس مناسب را از طریق مستندات نوین وان شروع کنید.