الطلبات

الطلبات هي تقارير الأخطاء وطلبات الميزات في مشروعك — المنشورات نفسها التي ينشئها مستخدموك في البوابة، معروضةً للقراءة والكتابة عبر الـ API. (وللملاحظات العامة نقطة نهاية خاصة بها؛ راجع الملاحظات.)

تتطلّب جميع نقاط النهاية المصادقة وهي محصورة بمشروع مفتاح الـ API.

سرد الطلبات

GET/v1/submissions

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


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

تستخدم الاستجابات مغلّف القوائم القياسي:


{
  "data": [
    {
      "id": "8f7a…",
      "type": "bug",
      "title": "Export button unresponsive on Safari",
      "body": "Clicking Export does nothing on Safari 26.",
      "status": "open",
      "is_private": false,
      "created_at": "2026-07-01T09:12:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "has_more": false }
}

جلب طلب

GET/v1/submissions/:id

يعيد طلبًا واحدًا بالشكل { "data": { … } }، أو خطأ 404 not_found.

إنشاء طلب

Pro يتطلّب وصول الكتابة خطة مدفوعة؛ وفي Free يعيد هذا 403 forbidden.

POST/v1/submissions

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


curl -X POST https://api.supdesk.app/v1/submissions \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "title": "Export button unresponsive on Safari",
    "email": "jamie@example.com",
    "body": "Clicking Export does nothing on Safari 26."
  }'

يعيد 201 مع الطلب المُنشأ. ويُنشأ المستخدم النهائي (أو يُطابَق بالبريد الإلكتروني) في قائمة عملاء مشروعك تلقائيًا.

تُحتسب الطلبات المُنشأة ضمن حصة طلباتك الشهرية تمامًا كطلبات البوابة. وعند السقف، تعيد نقطة النهاية هذه 429 limit_reached — ما لم يكن لدى مساحة عملك تجاوز طلبات مفعّل، وعندها يُقبل الطلب ويُفوتَر. راجع حدود المعدل والاستخدام.