Send Ticket

Description

配發票劵。（為避免久候建議配發票券總數量為60張以下）

Resource

POST /v3/ticket/send

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Request Body Parameters

Name	Type	Description
id	string	任務編號，不可重複(若需要銷毀票券時會以此任務編號進行)
send_data	SendData	配送資訊
quantity	integer	配發的票券總數量

Request Body Parameters - SendData

Name	Type	Description
ticket_no	string	活動票劵編號
vip_id_list	List[string]	會員編號列表
quantity	integer	配送票券張數

Request Example

{
  "id": "A0001",
  "send_data": [
    {
      "ticket_no": "12",
      "vip_id_list": [
        "APP000000001",
        "APP000000002"
      ],
      "quantity": 2
    },
    {
      "ticket_no": "13",
      "vip_id_list": [
        "APP000000001",
        "APP000000002",
        "APP000000003"
      ],
      "quantity": 1
    }
  ],
  "quantity": 7
}

Response Body Parameters - Success

Name	Type	Description
tickets	Ticket[]	票劵列表

Response Body Parameters - Ticket

Name	Type	Description
id	string	票劵編號
vip_id	string	會員編號
ticket_no	string	活動票劵編號

Response Body Parameters - Fail

Name	Type	Description
message	string	錯誤訊息

Response

Status-Code: 200 (全部票券配送成功)

{
  "tickets": [
    {
      "id": "T0001",
      "vip_id": "APP000000001",
      "ticket_no": "12"
    },
    {
      "id": "T0002",
      "vip_id": "APP000000002",
      "ticket_no": "12"
    },
    {
      "id": "T0003",
      "vip_id": "APP000000001",
      "ticket_no": "12"
    },
    {
      "id": "T0004",
      "vip_id": "APP000000002",
      "ticket_no": "12"
    },
    {
      "id": "B0001",
      "vip_id": "APP000000001",
      "ticket_no": "13"
    },
    {
      "id": "B0002",
      "vip_id": "APP000000002",
      "ticket_no": "13"
    },
    {
      "id": "B0003",
      "vip_id": "APP000000003",
      "ticket_no": "13"
    }
  ]
}

Status-Code:400 (票券配送失敗)

{
  "message": "票券狀態不允許銷售"
}