Tickets API — ایجاد، به‌روزرسانی و نظر

همه اندپوینت‌ها نیازمند Bearer token هستند. تیکت‌ها کد پیگیری با فرمت TK-XXXXXXXX دریافت می‌کنند.

GET /api/tickets

لیست تیکت‌ها. پارامترها: status (open/in-progress/closed)، priority، category، q، per_page (پیش‌فرض ۱۵).

curl -X GET "https://your-domain.com/api/tickets?status=open&per_page=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /api/tickets/stats

آمار تفکیکی به تفکیک وضعیت.

{ "success": true, "data": { "total": 27, "open": 12, "in_progress": 4, "closed": 11 } }

POST /api/tickets

ایجاد تیکت جدید.

فیلد	الزامی	توضیح
`subject`	بله	حداکثر ۲۵۵ کاراکتر
`message`	بله	حداقل ۱۰ کاراکتر
`priority`	خیر	`low`/`normal`/`high`
`category`	خیر	دسته
`tags`	خیر	آرایه آیدی تگ‌ها
`attachments`	خیر	حداکثر ۱۰MB فایل

curl -X POST https://your-domain.com/api/tickets \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"subject":"...","message":"...","priority":"high"}'

curl -X POST https://your-domain.com/api/tickets \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "subject=..." \
  -F "message=..." \
  -F "attachments[]=@/path/to/file.png"

GET /api/tickets/

جزئیات کامل تیکت شامل نظرات، پیوست‌ها، تگ‌ها و تاریخچه فعالیت‌ها.

PUT /api/tickets/

به‌روزرسانی priority یا category. تیکت‌های بسته ویرایش‌پذیر نیستند.

PUT /api/tickets//close

بستن تیکت.

POST /api/tickets//comments

افزودن نظر (حداقل ۵ کاراکتر). اگر تیکت بسته باشد، دوباره باز می‌شود.

GET /api/tickets//attachments//download

دانلود فایل پیوست. پاسخ باینری است، نه JSON.

curl -X GET https://your-domain.com/api/tickets/35/attachments/14/download \
  -H "Authorization: Bearer YOUR_TOKEN" \
  --output screenshot.png

​GET /api/tickets

​GET /api/tickets/stats

​POST /api/tickets

​GET /api/tickets/

​PUT /api/tickets/

​PUT /api/tickets//close

​POST /api/tickets//comments

​GET /api/tickets//attachments//download