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

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

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

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

شاهکار چه چیزی را بررسی می‌کند؟

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

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

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

تفاوت شاهکار با کد تأیید پیامکی چیست؟

کد پیامکی نشان می‌دهد کاربر در آن لحظه به پیام ارسال‌شده دسترسی دارد. شاهکار، تعلق شماره به کد ملی را بررسی می‌کند.

فرض کنید فروشنده‌ای می‌خواهد در یک مارکت‌پلیس حساب بسازد. شماره‌ای که وارد کرده در اختیار خودش است، اما به نام پدرش ثبت شده است. او می‌تواند کد پیامکی را دریافت کند؛ بااین‌حال، بررسی تطابق شماره با کد ملی خودش پاسخ منفی می‌دهد.

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

در کدام مرحله از محصول استفاده کنیم؟

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

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

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

برای انتخاب ترتیب مراحل نیز هزینه درخواست و تجربه کاربر را در نظر بگیرید. مثلاً اعتبارسنجی اولیه فرم و تأیید دسترسی به شماره، می‌توانند پیش از فراخوان سرویس انجام شوند تا درخواست‌های ناشی از اشتباه تایپی کمتر شوند.

پاسخ منفی را با خطای فنی اشتباه نگیرید

یکی از تصمیم‌های مهم پیاده‌سازی، نحوه برخورد با پاسخ‌هاست. «تطابق ندارد» با «سرویس پاسخ نداده» یکسان نیست.

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

اگر پاسخ فاقد داده مورد انتظار بود، آن را خودکار به پاسخ منفی تبدیل نکنید. تیم فنی باید این حالت را مطابق قرارداد پاسخ سرویس مدیریت کند.

پیش از اتصال، چه چیزهایی را بررسی کنیم؟

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

پیش از اجرای عمومی، چند مورد را مشخص کنید

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

همچنین تفاوت «انجام موفق درخواست» و «تطابق مثبت» را در گزارش‌ها حفظ کنید. ممکن است درخواست به‌درستی انجام شده باشد، اما نتیجه تطابق منفی باشد.

هزینه را چگونه برآورد کنیم؟

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

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

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

شروع اتصال برای کسب‌وکارها

درسرویس API حرازینو(ehrazino.com) مسیر ساخت حساب کسب‌وکار، دریافت کلید و استفاده از سرویس‌های API ارائه شده است. برای شروع، یک کاربرد مشخص انتخاب کنید و ابتدا اتصال را در محیط توسعه محصول خود بررسی کنید.

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

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

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