ایران ناتیفیکیشن

سفارش‌های فروشگاه ربات

سفارش‌های ثبت‌شده در ربات فروشگاهی.

GEThttps://api.irnoti.com/v1/botbuilder/bots/{id}/shop/orders
scope: bot.read

وضعیت: new، confirmed، shipped، done، canceled. payment روش پرداخت را فیلتر می‌کند.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ ربات.
statusquerystringفیلتر وضعیت سفارش.
paymentquerystringفیلتر روش پرداخت.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundربات پیدا نشد یا متعلق به شما نیست.

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

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

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

curl -X GET 'https://api.irnoti.com/v1/botbuilder/bots/5/shop/orders?status=new' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "18",
    "items": [
      {
        "qty": 1,
        "title": "کفش ورزشی"
      }
    ],
    "total": "1250000",
    "status": "new",
    "createdAt": "2026-10-30T09:30:00.000Z"
  }
]
سفارش‌های فروشگاه ربات — مستندات API | ایران ناتیفیکیشن