ساخت بازارسال کد تأیید

کد OTP تشخیص‌داده‌شده در صندوق را خودکار به مقصد دلخواه می‌فرستد.

POSThttps://api.irnoti.com/v1/email/otp-relays

scope: email.manage

پس از ساخت، یک کد ۶ رقمی به مقصد فرستاده می‌شود؛ با POST /email/otp-relays/{id}/verify تأیید کنید. mailbox و senderContains دامنهٔ بازارسال را محدود می‌کنند. channel یکی از sms، bale یا telegram است.

پارامترها

نام	محل	نوع	توضیح
channel *	بدنه	string	کانال مقصد.
target *	بدنه	string	شمارهٔ موبایل یا شناسهٔ گفتگو.
mailbox	بدنه	string	فقط این صندوق.
senderContains	بدنه	string	فقط فرستنده‌ای که نشانی‌اش شامل این متن است.
label	بدنه	string	برچسب نمایشی.

خطاهای خاص این endpoint

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.
400	validation_error	ورودی نامعتبر است؛ خطای هر فیلد در `details` آمده است.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی

فهرست بازارسال کد تأیید

بعدی ←

تأیید مقصد بازارسال

curl -X POST 'https://api.irnoti.com/v1/email/otp-relays' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "target": "09120000000",
  "channel": "sms",
  "senderContains": "github"
}'

پاسخ نمونه200 OK

{
  "id": "3",
  "label": "کد گیت‌هاب",
  "target": "09120000000",
  "channel": "sms",
  "enabled": false,
  "mailbox": "login@example.ir",
  "verified": false,
  "lastError": null,
  "sentTotal": 12,
  "lastSentAt": "2026-10-23T18:00:00.000Z",
  "senderContains": "github"
}