Geri Bildirim ve Analitik API

Geri bildirim biletleri, hijyen gönderimler, temizlik günlükleri ve ziyaretçi analitiği için REST API uç noktaları.

Geri Bildirim Biletleri

Biletleri Listele

GET /api/feedback

Sorgu parametreleri:

Parametre	Tür	Açıklama
`from`	ISO 8601	Başlangıç tarihi
`to`	ISO 8601	Bitiş tarihi
`location_id`	string	Konuma göre filtrele
`status`	string	`open`, `in_review`, `resolved`
`category`	string	Kategori slug'ına göre filtrele
`page`	number	Sayfa numarası
`per_page`	number	Maksimum: 100

Yanıt:

{
  "data": [
    {
      "id": "tkt_abc123",
      "location_id": "loc_def456",
      "category": "cleanliness",
      "description": "Tuvalet temizlenmeli.",
      "status": "open",
      "has_attachment": true,
      "contact_email": null,
      "created_at": "2026-06-07T09:15:00Z",
      "updated_at": "2026-06-07T09:15:00Z"
    }
  ],
  "meta": { "total": 58, "page": 1, "per_page": 20, "pages": 3 }
}

Bileti Getir

GET /api/feedback/:id

Notlar ve durum geçmişi dahil tam bileti döndürür.

Bilet Durumunu Güncelle

PATCH /api/feedback/:id

İstek gövdesi:

{ "status": "resolved" }

Hijyen Gönderimler

Hijyen Gönderimlerini Listele

GET /api/hygiene

Sorgu parametreleri: from, to, location_id, page, per_page

Yanıt:

{
  "data": [
    {
      "id": "hyg_001",
      "location_id": "loc_def456",
      "submitted_at": "2026-06-07T11:30:00Z",
      "scores": {
        "cleanliness": 4,
        "smell": 5,
        "supplies": 3,
        "general": 4
      },
      "average_score": 4.0,
      "comment": null
    }
  ],
  "meta": { "total": 320, "page": 1, "per_page": 20, "pages": 16 }
}

Hijyen Analitiğini Getir

GET /api/analytics/hygiene

Sorgu parametreleri: from, to, location_id

Konum ve kategori başına toplanmış puanları ve trend verilerini döndürür.

Temizlik Günlükleri

Temizlik Günlüklerini Listele

GET /api/cleaning

Sorgu parametreleri: from, to, location_id, personnel_id, page, per_page

Yanıt:

{
  "data": [
    {
      "id": "cln_001",
      "location_id": "loc_def456",
      "personnel_id": "prs_789",
      "personnel_name": "Personel A",
      "submitted_at": "2026-06-07T08:00:00Z",
      "tasks_completed": ["mopped", "stocked_supplies", "sanitised"],
      "notes": null
    }
  ],
  "meta": { "total": 180, "page": 1, "per_page": 20, "pages": 9 }
}

Ziyaretçi Analitiği

Analitik Panosunu Getir

GET /api/analytics/dashboard

Sorgu parametreleri: from, to

Seçilen dönem için çapraz modül KPI metriklerini döndürür:

{
  "period": { "from": "...", "to": "..." },
  "total_responses": 1247,
  "average_score": 4.2,
  "nps": 38,
  "active_locations": 47,
  "pending_tickets": 12,
  "cleaning_compliance_rate": 0.94
}

Ziyaretçi Olaylarını Getir

GET /api/analytics/visitor-events

Sorgu parametreleri: from, to, location_id, event_type (scan, form_open, submission, dropout)

Gün ve konuma göre gruplandırılmış toplanmış olay sayılarını döndürür.

Geri Bildirim ve Analitik API

Bu sayfada