English

通知一覧

GET/notifications

認証中ユーザー宛の通知を新しい順で取得します。削除済みの通知は含まれません。`unreadFirst=true` を指定すると未読を先頭にまとめ、その中を新しい順で並べます（ヘッダのドロップダウン向け）。

認証要ログイン

クエリパラメータ

limitnumber

取得件数。既定は 10。

offsetnumber

スキップする件数。既定は 0。

isReadboolean

既読状態で絞り込みます（true / false）。省略時は両方。

typestring

通知タイプで絞り込みます（NEW_MESSAGE / EVENT_ANNOUNCEMENT など）。

sincestring

この日時以降に作成された通知のみ返します（ISO 8601）。

unreadFirstboolean

true のとき未読を先に並べます。

補足

通知に表示用の文面は含まれません。`type` で文言テンプレートを選び、`messageParams` を差し込んでクライアント側でローカライズしてください。

`metadata` には遷移先を組み立てるための値が入ります（`roomId` / `eventId` / `eventSlug` / `communityId` / `communitySlug` / `announcementId` など）。含まれるキーは通知タイプごとに異なります。

`total` と `unreadCount` は `since` などの絞り込みを反映した件数です。バッジと一覧の件数を揃えたい場合は、両者で同じ `since` を指定してください。

レスポンス

フィールド型説明
notificationsNotification[]通知配列。
totalnumber絞り込み条件に一致する総件数。
unreadCountnumber同じ絞り込み条件での未読件数。
リクエスト
curl https://api.4s.link/notifications \
  -H "Authorization: Bearer 4s_at_..."
レスポンス例
{
  "notifications": [
    {
      "id": "5f2a1c40-...",
      "userId": "9c3b7e21-...",
      "type": "EVENT_ANNOUNCEMENT",
      "messageParams": {
        "eventName": "4S Conference 2026",
        "announcementTitle": "受付開始時刻のお知らせ"
      },
      "isRead": false,
      "relatedId": "0b6d4f88-...",
      "metadata": {
        "eventId": "0b6d4f88-...",
        "eventSlug": "4s-conference-2026",
        "announcementId": "7ae2c915-..."
      },
      "createdAt": "2026-08-19T02:30:00.000Z",
      "updatedAt": "2026-08-19T02:30:00.000Z"
    }
  ],
  "total": 34,
  "unreadCount": 3
}