تأیید تلفنی
به مخاطب زنگ میزند تا کدی را تایپ یا گزینهای را انتخاب کند.
POST
scope: sms.sendhttps://api.irnoti.com/v1/voice-confirmمناسب تأیید پرداخت، سفارش یا هویت. نتیجه را با GET /voice-confirm/{id} بگیرید. سقف ۲۰ در دقیقه.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| to * | بدنه | string | شمارهٔ مخاطب. |
| mode * | بدنه | string | code (کاربر کد را تایپ کند) یا choice (انتخاب با کلید). |
| prompt * | بدنه | object | پیام ابتدایی: متن گفتار یا فایل صوتی. |
| code | بدنه | string | حالت code: ارقام (۳ تا ۸) که کاربر باید وارد کند. |
| options | بدنه | object | حالت choice: کلید ← برچسب (۲ تا ۹ گزینه). |
| transfers | بدنه | object | حالت choice: کلید ← داخلی برای وصل شدن. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 402 | insufficient_balance | اعتبار کافی نیست. |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.