English

チケットを更新

PUT/manage/events/:eventId/tickets/:ticketId

チケット種別を更新します。ticketsWrite 権限が必要です。price と paymentType は販売開始後に変更できません。

認証要ログイン

パスパラメータ

eventIdstring必須

イベント ID または slug。

ticketIdstring必須

チケット ID。

リクエストボディ

namestring

チケット名。作成時は必須。100 文字以内（前後の空白は除去される）

descriptionstring

説明。500 文字以内。

languagesobject

多言語の名称・説明。

salesLimitnumber

販売上限枚数。0 以上の整数。null で無制限。

statusstring

DRAFT / PUBLISHED / PRIVATE のいずれか。

confirmUserBasicInfoboolean

購入時に基本情報の確認を求めるか。

requiresApprovalboolean

参加登録に承認を要するか。

transferableboolean

他ユーザーへ譲渡可能か。

invitationEnabledboolean

招待機能を有効にするか。イベントの enabledReferralTree が有効な場合のみ true にできる（無効なイベントで true を送ると 400）

invitationTargetTicketIdstring

招待で発行するチケット ID。同じイベントのチケットであること。invitationEnabled を true にする場合は必須。

invitationMaxGenerations / invitationLimitnumber

招待の世代数は 1 または 2、1 人あたりの招待上限は 1 以上の整数。

invitationDiscountEnabled / invitationDiscountPercent / invitationDiscountAmountboolean | number

招待割引の設定。有効にする場合は percent（0〜100）または amount（0 以上）のどちらかが必須。割引は招待先チケットが有料の場合のみ適用される。

オブジェクトの構造

languages

言語コードをキーに、その言語で表示する title / description を指定します。指定した言語のみ上書きされ、未指定の言語は既定のフィールドが使われます。

<lang>object

言語コード（ja / en など）

<lang>.titlestring

その言語で表示するタイトル。

<lang>.descriptionstring

その言語で表示する説明。

{
  "ja": { "title": "オープニング基調講演", "description": "..." },
  "en": { "title": "Opening Keynote", "description": "..." }
}

補足

招待（リファラル）関連の設定は、イベントの enabledReferralTree（リファラルツリー）が有効な場合のみ指定できます。enabledReferralTree はプラットフォーム運営用の admin API でのみ有効化できるため、無効なイベントで invitationEnabled に true を送ると 400（VALIDATION_ERROR）になります。

リクエスト
curl https://api.4s.link/manage/events/EVENT_ID/tickets/TICKET_ID \
  -X PUT \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "一般チケット（早割）",
  "salesLimit": 300
}'
レスポンス例
{
  "id": "t1a2b3c4-...",
  "name": "一般チケット",
  "description": "...",
  "price": 5000,
  "paymentType": "PREPAID_STRIPE",
  "salesLimit": 200,
  "status": "PUBLISHED",
  "confirmUserBasicInfo": true,
  "requiresApproval": false,
  "transferable": true,
  "invitationEnabled": false,
  "order": 0
}