notifications — Blesyum Core API

GET/api/v1/notifications

List the signed-in user's recent in-app notifications (NOT-02).

Oturum

Query: `?limit=&offset=&unread=` — all optional. With no params this returns the 50 most recent (back-compat with the overview feed, which expects a bare array). The inbox passes `limit`/`offset` for "load more" and `unread=1` to filter to unread. Response stays a bare `NotificationRow[]`; the client derives `has_more` from `batch.length === limit`.

İstek

curl -X GET "https://api.blesyum.com/api/v1/notifications" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/v1/notifications/preferences

Read the user's notification preferences (NOT-05).

Oturum

İstek

curl -X GET "https://api.blesyum.com/api/v1/notifications/preferences" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/v1/notifications/preferences

Merge a patch into the user's notification preferences (NOT-05).

Oturum

İstek

curl -X PATCH "https://api.blesyum.com/api/v1/notifications/preferences" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/v1/notifications/read

Mark one notification (or all) read (NOT-02).

Oturum

İstek

curl -X POST "https://api.blesyum.com/api/v1/notifications/read" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/v1/notifications/unread-count

Unread notification count (the bell badge, NOT-02).

Oturum

İstek

curl -X GET "https://api.blesyum.com/api/v1/notifications/unread-count" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}