مسیر پشتیبان OTP
در کنار OTP پیامکی برای افزایش پایداری ورود کاربران.
Voice OTP
OTP صوتی برای ارسال کد تأیید از طریق تماس تلفنی استفاده میشود و بهعنوان مسیر پشتیبان برای زمانی مناسب است که پیامک بهموقع به کاربر نمیرسد یا کسبوکار به احراز هویت پایدارتر نیاز دارد.
POST https://wikipayam.ir/api/v1/voice-otp/send
Authorization: Bearer YOUR_AUTH_TOKEN_HERE
Accept: application/json
Content-Type: application/json
این مسیر برای سرویسهایی مناسب است که احراز هویت نباید فقط به رسیدن پیامک وابسته باشد.
در کنار OTP پیامکی برای افزایش پایداری ورود کاربران.
مناسب ورود، تراکنش، بازیابی دسترسی و عملیات مهم.
کد را سامانه شما تولید میکند و در فیلد code میفرستد.
توکن فقط باید در backend و فایلهای امن مثل .env نگهداری شود.
{
"receiver": "09123456789",
"code": "123456",
"track_id": "ORDER-1001"
}
{
"data": {
"message": "Voice OTP queued successfully",
"id": "6a02f05a3492873a9e086e86",
"track_id": "ORDER-1001"
}
}
curl --location --request POST 'https://wikipayam.ir/api/v1/voice-otp/send' \
--header 'Authorization: Bearer YOUR_AUTH_TOKEN_HERE' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"receiver": "09123456789",
"code": "123456",
"track_id": "ORDER-1001"
}'
توکن واقعی را هرگز در JavaScript عمومی، URL، مخزن Git یا ابزارهای قابل مشاهده کاربر قرار ندهید.
OTP صوتی روشی برای ارسال کد تأیید از طریق تماس تلفنی است و در سناریوهای حساس میتواند مسیر پشتیبان OTP پیامکی باشد.
زمانی که رسیدن پیامک بهموقع برای کاربر حیاتی است یا سرویس شما به مسیر جایگزین برای احراز هویت نیاز دارد.
معمولاً مکمل OTP پیامکی است؛ میتوانید ابتدا پیامکی بفرستید و در صورت نیاز از تماس صوتی بهعنوان مسیر پشتیبان استفاده کنید.
بسته به تنظیمات پنل و نوع سرویس، token عملیاتی از پنل/پشتیبانی ویکیپیام دریافت و فقط سمت سرور استفاده میشود.
در نمونه API، کد OTP توسط سامانه شما تولید و در فیلد code به API ارسال میشود.
برای دریافت token، بررسی سناریو و اتصال امن API با تیم ویکیپیام هماهنگ کنید.