الملاحظات

تعكس نقاط نهاية الملاحظات الطلبات تمامًا، لكنها تعمل على منشورات من نوع feedback — مدخلات مفتوحة ليست تقرير خطأ ولا طلب ميزة.

GET/v1/feedback

Parameter	Type	Description
`status`	`string`	التصفية حسب الحالة: backlog أو open أو planned أو in_progress أو done.
`limit`	`integer`	حجم الصفحة. الافتراضي 20.
`offset`	`integer`	عدد العناصر المراد تخطّيها. الافتراضي 0.

GET/v1/feedback/:id

POST/v1/feedback

Parameter	Type	Description
`title`required	`string`	ملخّص قصير.
`email`required	`string`	البريد الإلكتروني للمستخدم النهائي.
`body`	`string`	وصف أطول.
`name`	`string`	اسم العرض للمستخدم النهائي.
`locale`	`string`	لغة رسائل الإشعار التي يُطلقها هذا (en, ar, de, es, fr, he, hi, it, ja, ru, zh). الافتراضي en.

يُقاس إنشاء الملاحظات مقابل حصة الطلبات الشهرية نفسها ويتطلّب وصول كتابة بخطة مدفوعة Pro.

سرد الملاحظات


curl "https://api.supdesk.app/v1/feedback?status=open&limit=10" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": [
    {
      "id": "8f7a...",
      "type": "feedback",
      "title": "Add dark mode support",
      "body": "Would love to see a dark theme option for the dashboard.",
      "status": "open",
      "is_private": false,
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

جلب عنصر ملاحظات


curl "https://api.supdesk.app/v1/feedback/8f7a..." \
  -H "Authorization: Bearer sd_live_..."


{
  "data": {
    "id": "8f7a...",
    "type": "feedback",
    "title": "Add dark mode support",
    "body": "Would love to see a dark theme option for the dashboard.",
    "status": "open",
    "is_private": false,
    "created_at": "2026-07-01T09:12:00Z"
  }
}

إنشاء ملاحظة


curl -X POST https://api.supdesk.app/v1/feedback \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Add dark mode support",
    "email": "jamie@example.com",
    "body": "Would love to see a dark theme option for the dashboard.",
    "name": "Jamie"
  }'


{
  "data": {
    "id": "8f7a...",
    "type": "feedback",
    "title": "Add dark mode support",
    "body": "Would love to see a dark theme option for the dashboard.",
    "status": "open",
    "is_private": false,
    "created_at": "2026-07-01T09:12:00Z"
  }
}