チケットを作成(管理者用)
/manage/events/:eventId/ticketsチケット種別を作成します。ticketsWrite 権限が必要です。有料チケットには price と paymentType の指定が必要で、Stripe Connect の設定が済んでいる必要があります。
| 認証 | 要ログイン |
|---|
パスパラメータ
eventIdstring必須イベント ID または slug。
リクエストボディ
pricenumber必須価格。0 以上の整数。paymentType が ONSITE_PAYMENT / PREPAID_STRIPE の場合は 1 以上であること。販売開始後は変更できない。
paymentTypestring必須FREE(無料) / ONSITE_PAYMENT(当日現地払い) / PREPAID_STRIPE(事前決済)のいずれか。PREPAID_STRIPE はイベントの Stripe 決済が有効な場合のみ。販売開始後は変更できない。
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 \-X POST \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"name": "一般チケット","price": 5000,"paymentType": "PREPAID_STRIPE","salesLimit": 200,"status": "PUBLISHED"}'
{"id": "t1a2b3c4-...","name": "一般チケット","description": "...","price": 5000,"paymentType": "PREPAID_STRIPE","salesLimit": 200,"status": "PUBLISHED","confirmUserBasicInfo": true,"requiresApproval": false,"transferable": true,"invitationEnabled": false,"order": 0}