リファラル影響力ランキング

GET/events/:eventId/referral-ranking

イベントの招待チェーンに基づく影響力ランキング（上位 100 件）を取得します。

認証	不要

パスパラメータ

eventIdstring必須

イベント ID

クエリパラメータ

rankingType'SCORE' | 'DESCENDANT_COUNT'

ランキング種別。デフォルト DESCENDANT_COUNT

periodType'DAILY' | 'WEEKLY' | 'ALL_TIME'

集計期間。デフォルト ALL_TIME

date / rangestring

期間の基準日・レンジ

genesisOnly'true'

起点（招待の始点）のみ

レスポンス

フィールド	型	説明
`rankingType / periodType`	string	ランキング条件
`items`	object[]	ランキング配列（rank / score / user / 各種招待数）
`generatedAt`	string	生成時刻

curl https://api.4s.link/events/EVENT_ID/referral-ranking \
  -H "Authorization: Bearer 4s_at_..."

レスポンス例
{
  "rankingType": "DESCENDANT_COUNT",
  "periodType": "ALL_TIME",
  "periodStartDate": "2026-01-01",
  "periodEndDate": null,
  "timezone": "Asia/Tokyo",
  "genesisOnly": false,
  "generatedAt": "2026-07-01T00:00:00.000Z",
  "items": [
    {
      "rank": 1,
      "score": 10,
      "entryId": "en1-...",
      "user": { "id": "a1b2c3d4-...", "slug": "taro", "firstName": "太郎" },
      "directInviteCount": 3,
      "indirectInviteCount": 7,
      "descendantCount": 10,
      "checkedInInviteCount": 5
    }
  ]
}