Tüm isteklerde X-Tenant header’ı zorunludur. İşlemler ve listelemeler sadece belirtilen tenant’a bağlı hastaların destek talepleri ile sınırlandırılmıştır.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
GET | /api/v1/tickets | Destek taleplerini filtreli olarak listeler |
GET | /api/v1/tickets/{id} | Tek bir destek talebini detaylı getirir |
POST | /api/v1/tickets | Yeni destek talebi oluşturur |
PUT | /api/v1/tickets/{id} | Destek talebini kısmi günceller |
DELETE | /api/v1/tickets/{id} | Destek talebini soft delete eder |
DELETE | /api/v1/tickets/{id}/force | Destek talebini kalıcı olarak siler |
Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın. Destek talebi kavramı
Ticket (destek talebi); bir hastanın / müşterinin genel taleplerini, şikayetlerini, yan etki bildirimlerini veya önerilerini takip etmek için kullanılan sistem kaydıdır.
Bir destek talebi; ilgili hasta, atanmış personel (sorumlu), talep tipi, durum, açıklama ve kanban sıralaması (position) gibi bilgilerle yönetilir.
İş kuralları
customer_id başka bir tenant’a ait bir hastayı işaret ediyorsa hata döner: The selected customer does not belong to this tenant.
code — Sistem tarafından otomatik ve benzersiz olarak üretilir.creation_type — API üzerinden oluşturulan tüm taleplerde otomatik olarak manual atanır.
position alanı: Kanban board vb. arayüzlerde kart sıralamasını tutmak için kullanılır. Genellikle güncelleme (PUT) isteğinde gönderilir.
Yetkilendirme
Uygulama izinleri (permissions)
| İşlem | Permission |
|---|
| Listeleme | ViewAny:Ticket |
| Detay / Tek gösterme | View:Ticket |
| Oluşturma | Create:Ticket |
| Güncelleme | Update:Ticket |
| Silme (soft delete) | Delete:Ticket |
| Kalıcı silme (force delete) | ForceDelete:Ticket |
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Okuma (index, show) | tickets:read |
Yazma (store, update, destroy, forceDelete) | tickets:write |
