פניות

הפניות הן דיווחי הבאגים ובקשות היכולות של הפרויקט שלכם — אותם פוסטים שהמשתמשים שלכם יוצרים בפורטל, חשופים לקריאה ולכתיבה דרך ה-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 — אלא אם כן בסביבת העבודה שלכם מופעלת חריגת פניות, ואז הפנייה מתקבלת ומחויבת. ראו מגבלות קצב ושימוש.