Bildirim Listesi

Tüm bildirimleri listeler.

Endpoint

GET /api/v1/notifications

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

• notifications.view - Tüm bildirimleri görüntüleme
• notifications.view.own - Sadece kendi bildirimlerini görüntüleme

Request

Headers

Header	Değer	Zorunlu
Authorization	Bearer \{token\}	Evet

Query Parameters

Parametre	Tip	Zorunlu	Açıklama
type	string	Hayır	Bildirim tipi
is_read	boolean	Hayır	Okunma durumu filtresi
is_active	boolean	Hayır	Aktif/pasif filtresi
with_trashed	boolean	Hayır	Silinen bildirimleri de dahil et
page	integer	Hayır	Sayfa numarası (varsayılan: 1)
per_page	integer	Hayır	Sayfa başına kayıt (varsayılan: 15, max: 100)

Response

Success Response (200 OK)

{
  "data": [
    {
      "id": 1,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": 1,
      "sender_id": 2,
      "type": "info",
      "title": "Yeni Mesaj",
      "message": "Size yeni bir mesaj geldi",
      "action_url": "/messages/123",
      "is_read": false,
      "read_at": null,
      "is_active": true,
      "user": {
        "id": 1,
        "email": "user@example.com"
      },
      "sender": {
        "id": 2,
        "email": "sender@example.com"
      },
      "created_at": "2025-11-20T12:00:00.000000Z"
    }
  ],
  "current_page": 1,
  "per_page": 15,
  "total": 1,
  "last_page": 1
}

Code Examples

cURL

curl -X GET https://api.example.com/api/v1/notifications \
  -H "Authorization: Bearer \{token\}"

Filtreleme Örnekleri

# Okunmamış bildirimler için
curl -X GET "https://api.example.com/api/v1/notifications?is_read=false" \
  -H "Authorization: Bearer \{token\}"

# Belirli bir tip için
curl -X GET "https://api.example.com/api/v1/notifications?type=info" \
  -H "Authorization: Bearer \{token\}"

Notes

• Varsayılan olarak sadece aktif bildirimler döner
• .own permission'ı olan kullanıcılar sadece kendi bildirimlerini görür
• Bildirimler en yeni tarih sırasına göre döner (latest())
• Bildirimler kullanıcı ve gönderen bilgileri ile birlikte döner

Related Endpoints

• Bildirim Oluştur - Yeni bildirim gönder
• Bildirim Detayı - Bildirim detayını getir