イベント(管理者用)
チケットを更新(管理者用)
PUT
/manage/events/:eventId/tickets/:ticketIdチケット種別を更新します。ticketsWrite 権限が必要です。price と paymentType は販売開始後に変更できません。
| 認証 | 要ログイン |
|---|
パスパラメータ
eventIdstring必須イベント ID または slug。
ticketIdstring必須チケット ID。
リクエストボディ
namestring任意チケット名。100 文字以内(前後の空白は除去される)
descriptionstring任意説明。500 文字以内。
多言語の名称・説明。
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 以上)のどちらかが必須。割引は招待先チケットが有料の場合のみ適用される。
補足
招待(リファラル)関連の設定は、イベントの enabledReferralTree(リファラルツリー)が有効な場合のみ指定できます。enabledReferralTree はプラットフォーム運営用の admin API でのみ有効化できるため、無効なイベントで invitationEnabled に true を送ると 400(VALIDATION_ERROR)になります。
レスポンス
Ticket を返します。
リクエスト
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}