مستنداتv1 stablehttps://api.irnoti.com/v1

ثبت ربات

توکن ربات را ثبت کنید و لینک اختصاصی بگیرید.

POSThttps://api.irnoti.com/v1/broker/bots

scope: broker.write

توکن از طریق بروکر با getMe سنجیده می‌شود و رمزنگاری‌شده ذخیره می‌شود؛ هرگز در پاسخ‌ها برنمی‌گردد. کلید API فقط وقتی کار می‌کند که اشتراک شما قابلیت «کلید وب‌سرویس» و بروکر را داشته باشد.

پارامترها

نام	محل	نوع	توضیح
label *	بدنه	string	نام دلخواه (حداکثر ۸۰ نویسه).
service	بدنه	string	نوع سرویس؛ پیش‌فرض telegram.
token *	بدنه	string	توکن ربات از BotFather.

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

400	invalid_token	تلگرام توکن را نپذیرفت.
409	bot_limit	به سقف تعداد ربات رسیده‌اید.
409	bot_exists	این ربات قبلاً ثبت شده است.
403	subscription_required	برای استفاده اشتراک فعال لازم است.

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

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

curl -X POST 'https://api.irnoti.com/v1/broker/bots' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "label": "ربات فروشگاه",
  "token": "123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}'

پاسخ نمونه200 OK

{
  "id": "31",
  "link": "https://broker.irnoti.com/b3f9a1c2/9e1f0c…",
  "label": "ربات فروشگاه",
  "username": "my_shop_bot",
  "suspended": false,
  "webhookUrl": null
}