Allmine API
Notifications

Bildirimleri listele (v2)

İstek atan kullanıcının bildirimlerini filtreleme ve sayfalama seçenekleriyle birlikte getirir.

GET
/api/v2/notifications

İstek atan kullanıcının bildirimlerini filtreleme ve sayfalama seçenekleriyle birlikte getirir.

Authorization

JWT-auth
AuthorizationBearer <token>

Paste the JWT access token without the Bearer prefix.

In: header

Query Parameters

type?string

Bildirim tipi filtresi

Value in"system"
category?string

Bildirim kategorisi filtresi

Value in"live_stream" | "payments" | "follows" | "messages" | "following_activity" | "announcement"
read?boolean

Okunma durumu filtresi

isRead?booleanDeprecated

Legacy okunma filtresi (deprecated)

page?number

Sayfa numarası (varsayılan: 1)

Default1
Range1 <= value
limit?number

Sayfa başına öğe sayısı (varsayılan: 20, maksimum: 100)

Default20
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/notifications"
{
  "isSuccess": true,
  "statusCode": 200,
  "data": {
    "list": [
      {
        "id": "abc123",
        "username": "john_doe",
        "email": "[email protected]"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 5,
      "totalItems": 45,
      "itemsPerPage": 10,
      "hasNextPage": true,
      "hasPrevPage": false
    }
  },
  "errors": [],
  "timestamp": "2026-05-22T16:11:27.078Z"
}
{
  "isSuccess": false,
  "statusCode": 400,
  "data": null,
  "errors": [
    "Validation failed"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 401,
  "data": null,
  "errors": [
    "Authentication required"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 403,
  "data": null,
  "errors": [
    "Insufficient permissions"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}

Yeni bildirim oluştur POST

**Production uyarisi:** Bu endpoint veri degistirir veya operasyon tetikleyebilir. API Playground icinde Production server seciliyse gercek production verisi etkilenir; test icin Development server kullanin. Kullanıcı için yeni bir bildirim oluşturur

Bildirim durumunu güncelle PATCH

**Production uyarisi:** Bu endpoint veri degistirir veya operasyon tetikleyebilir. API Playground icinde Production server seciliyse gercek production verisi etkilenir; test icin Development server kullanin. Bildirimin okundu/okunmadı durumunu günceller