Allmine API
Notifications

Bildirimleri listele

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

GET
/api/v1/notifications

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

Authorization

JWT-auth
AuthorizationBearer <token>

Paste the JWT access token without the Bearer prefix.

In: header

Query Parameters

type?string

Filter by notification type

Value in"system"
category?string

Filter by notification category

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

Filter by read status

isRead?booleanDeprecated

Deprecated: use read filter instead

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/notifications"
{
  "isSuccess": true,
  "statusCode": 200,
  "data": [
    {
      "id": "64d15f9e2e6c8f4d5a123456",
      "userId": "64d15f9e2e6c8f4d5a123456",
      "type": "system",
      "category": "live_stream",
      "title": "Sample title",
      "message": "Sample description",
      "metadata": {},
      "read": true,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-15T10:30:00.000Z"
    }
  ],
  "errors": [],
  "timestamp": "2026-05-22T16:11:27.077Z"
}
{
  "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"
}

Takip durumunu kontrol et GET

Authenticated kullanıcının belirtilen kullanıcıyı takip edip etmediğini kontrol eder.

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