English

リファラル祖先（招待元チェーン）

GET/events/:eventId/entries/:entryId/referral-ancestors

指定参加登録から招待元を上方向に辿り、対象に近い順で返します。呼び出しユーザーが当該イベントの確定参加者（CONFIRMED / CHECKED_IN）でない場合は 403 です。

認証要ログイン

パスパラメータ

eventIdstring必須

イベント ID

entryIdstring必須

対象の参加登録 ID

クエリパラメータ

generationsnumber

取得する祖先の最大段数。デフォルト 10（1〜50 にクランプ）

レスポンス

フィールド型説明
entryIdstring対象の参加登録 ID
entryobject対象の参加登録ノード（軽量 DTO）
ancestorsobject[]対象に近い順の祖先配列（無効 state の親は disabled: true / user: null）
truncatedboolean無効 state・親欠損・段数上限のいずれかで打ち切った場合 true
リクエスト
curl https://api.4s.link/events/EVENT_ID/entries/:entryId/referral-ancestors \
  -H "Authorization: Bearer 4s_at_..."
レスポンス例
{
  "entryId": "770fa622-...",
  "entry": {
    "id": "770fa622-...",
    "invitedByEntryId": "660e9511-...",
    "invitationGeneration": 2,
    "invitationRootEntryId": "550e8400-...",
    "user": { "id": "2b3c4d5e-...", "slug": "carol-lee", "firstName": "Carol", "lastName": "Lee" },
    "ticketName": "招待参加"
  },
  "ancestors": [
    {
      "id": "660e9511-...",
      "invitedByEntryId": "550e8400-...",
      "invitationGeneration": 1,
      "invitationRootEntryId": "550e8400-...",
      "user": { "id": "1a2b3c4d-...", "slug": "bob-sato", "firstName": "Bob", "lastName": "Sato" },
      "ticketName": "招待参加"
    }
  ],
  "truncated": false
}