English

未読件数の統合取得

GET/users/me/unread-counts

認証中ユーザーのチャット・お知らせ・通知の未読件数を 1 リクエストで返します。タブやアプリアイコンのバッジのように、複数の未読を同時に出す画面のためのエンドポイントです。

認証要ログイン

クエリパラメータ

sincestring

この日時以降に作成された通知のみカウントします（ISO 8601）。チャットの未読は既読位置を基準にするため影響を受けません。

補足

`announcements` は `notifications` の部分集合です（お知らせも未読通知として数えます）。`badge` は未読メッセージ数と、チャット以外の未読通知の合計で、アプリアイコンのバッジにそのまま使えます。

レスポンス

フィールド型説明
chat.messagesnumber未読メッセージの総数。
chat.roomsnumber未読があるチャットルーム数。
chat.byCategoryobject種別（chat / event / community）ごとの未読メッセージ数。
announcementsnumberお知らせ由来の未読通知件数。
notificationsnumber未読通知件数（全種別）。
badgenumberアプリアイコンのバッジに使う件数。
リクエスト
curl https://api.4s.link/users/me/unread-counts \
  -H "Authorization: Bearer 4s_at_..."
レスポンス例
{
  "chat": {
    "messages": 12,
    "rooms": 3,
    "byCategory": { "chat": 5, "event": 4, "community": 3 }
  },
  "announcements": 2,
  "notifications": 5,
  "badge": 15
}