Çalışma alanı

Bildirimleri listele

Kullanıcının son bildirimleri (en yenisi önce) ve okunmamış sayısı. Her satır: kind (tür — mention, comment, task, assign, approval, deal, ticket, email, call, summary, flow, support — Solk desteği yanıtı, system), kind_label, title (kısa başlık, ör. Teklif onayınızı bekliyor), body (açıklama, ör. T-2026-0044 · Kuzey Plastik A.Ş. · %14 iskonto), message (eski tek satır metin), link, is_read, created_at ve nav (uygulamada açılacak ekran; yoksa null). v=2 ile ayrıca actor (bildirimi doğuran işlemi yapan kişi: id, name, initials, color, photo) ve alt (uygulamada ekranı olmayan bağlantının ilgili kaydı — ör. destek talebi → firma: screen, id, label, name); yanıtta last_id, more (daha eski var), filter, filters. Sistem bildirimleri (lisans, kullanım faturası, arka plan işleri) yalnız filter=system ile gelir (yönetici); unread sayısına girmez. v gönderilmezse eski biçim: sistem bildirimi yok, uygulamada ekranı olmayan bağlantı boş (link: "").

GET/api/v1/notifications

Yetkilendirme

Authorizationheaderzorunlu
Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Kapsam: crm.read

Sorgu parametreleri

vstringisteğe bağlı
2 = başlık, açıklama, kişi ve ilgili kayıtla yeni biçim.
filterstringisteğe bağlı
Yalnız v=2: süzgeç.
Değerlerallunreadmentionassignapprovalsystem
sinceintegeristeğe bağlı
Bu kimlikten yeni olanlar (uygulama açıkken yeni bildirim yoklaması).
beforeintegeristeğe bağlı
Bu kimlikten eski olanlar (sayfalama).
limitintegeristeğe bağlı
En çok satır (1–100, varsayılan 50).
İstek
curl "https://ornek.solk.app/api/v1/notifications?v=2&limit=5" \
  -H "Authorization: Bearer $SOLK_API_KEY"
Yanıt
{
  "filter": "all",
  "filters": [
    {
      "k": "all",
      "label": "Tümü"
    },
    {
      "k": "unread",
      "label": "Okunmamış"
    }
  ],
  "last_id": 3,
  "more": false,
  "ok": true,
  "rows": [
    {
      "actor": {
        "color": "#b95ccd",
        "id": 2,
        "initials": "AD",
        "name": "Ayşe Demir",
        "photo": null
      },
      "alt": null,
      "body": "@Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
      "created_at": "2026-10-15T10:59:07",
      "id": 3,
      "is_read": false,
      "kind": "mention",
      "kind_label": "Bahsetme",
      "link": "/customers/1?note=1#cNotes",
      "message": "Ayşe Demir sizden bahsetti: @Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
      "nav": {
        "id": 1,
        "screen": "customer"
      },
      "title": "Ayşe Demir sizden bahsetti"
    },
    {
      "actor": {
        "color": "#b95ccd",
        "id": 2,
        "initials": "AD",
        "name": "Ayşe Demir",
        "photo": null
      },
      "alt": null,
      "body": "Yeni Müşteri · 2026 · Alize Paketleme San. ve Tic. A.Ş.",
      "created_at": "2026-10-15T10:42:07",
      "id": 2,
      "is_read": false,
      "kind": "assign",
      "kind_label": "Devir",
      "link": "/opportunities/1",
      "message": "Size devredilen fırsat: Alize Paketleme San. ve Tic. A.Ş. · Yeni Müşteri · 2026",
      "nav": {
        "id": 1,
        "screen": "opp"
      },
      "title": "Fırsat size devredildi"
    }
  ],
  "unread": 3
}

Örnek yanıt örnek veriyle çalışan bir v98 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.