POST api/Products2?startdate={startdate}&enddate={enddate}&seatareaid={seatareaid}&theatreid={theatreid}&senceid={senceid}&tripbillcode={tripbillcode}
获取演艺剧场产品(门票)列表。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| startdate |
(可选)起始日期,不输入或输入空时表示当天,格式yyyyMMdd。 |
string |
Default value is |
| enddate |
(可选)截止日期,不输入或输入为空时,表示起始日期后天7天,startdate和enddate相距的时间周期不能超过七天。 |
string |
Default value is |
| seatareaid |
座位区域ID |
string |
Default value is |
| theatreid |
(可选)剧场ID |
string |
Default value is |
| senceid |
(可选)场次ID |
string |
Default value is |
| tripbillcode |
(可选)行程单单号 |
string |
Default value is |
Body Parameters
None.
Response Information
Resource Description
获取演艺剧场产品(门票)列表。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。
Collection of Products2| Name | Description | Type | Additional information |
|---|---|---|---|
| productid |
产品ID,唯一地标识每一个门票的类型。 |
string |
None. |
| productname |
产品名称。 |
string |
None. |
| theaterid |
剧场ID,指明当前产品隶属于哪一个剧场。 |
string |
None. |
| theatername |
剧场名称,指明当前产品隶属于哪一个剧场。 |
string |
None. |
| sceneid |
场次ID,指明当前产品所隶属的场次。 |
string |
None. |
| scenename |
场次名称,指明当前产品所隶属的场次的名称。 |
string |
None. |
| scenenstarttime |
场次开始时间,指明当前产品对应场次的开演时间(同一产品,不同日期此值可能是不同的)。 |
string |
None. |
| scenenendtime |
场次结束时间,指明当前产品对应场次的演出结束时间(同一产品,不同日期此值可能是不同的)。 |
string |
None. |
| ticketdate |
日期(YYYYMMDD),指明当前产品对应的日期(指明当前产品所包含的属性对这个日期而言有效)。 |
string |
None. |
| enablecount |
当前空闲票数,指明当前产品,ticketdate所指示的日期,sceneid所指示的场次,有多少空闲票数(注意,票数不定是座位数,只有当每票指定为一个座位时,两者才相等。如果票是情侣票,指定必须绑定2个座位,则票数是座位数的一半,依此类推)。 |
integer |
None. |
| unit |
单位,一般是“张”。 |
string |
None. |
| price |
价格 |
decimal number |
None. |
| conditionsofsale |
许可条件,“1”仅授权地接社和部门......属于电子门票系统设置,对接口方而言没有含义。 |
string |
None. |
| minimum |
最小单笔出售数量,0表示没有限制。 |
integer |
None. |
| maximum |
最大单笔出售数量,0表示没有限制。 |
integer |
None. |
| singleidmaximum |
单ID日最大购买限制,指明单个代理商,每日最大许可销售量。 |
integer |
None. |
| preorderdays |
产品有效日数,注意这个单词的拼写是错误的,指示当前票的有效时长。如果单纯是看演出,则一定为一日有效(值为1),但如果票含有其他权利(如景区+演艺套票产品),则可以大于1。 |
integer |
None. |
| webpredays |
互联网预定提前日数,指明当前产品至少需要提前多少天发起预订(0表示当天可订,即订即可使用的意思)。 |
integer |
None. |
| needname |
是否需要实名制,“1”表示需要实名制,则每个票需要一个证件号及姓名,“0”表示不需要实名制。 |
string |
None. |
| perpersonperticket |
是否一人一票,“1”表示一人一票。 |
string |
None. |
| isnormalticket |
是否为常规门票,对应到系统中的“是否作门票使用”的设置。 作门票使用是指“可以被前台和互联网出售”的常规门票,用于区别可以使用返款余额支付的返款票。 “1”表示是,其他值表示否。 |
string |
None. |
| isrebateticket |
是否作为返利票,对应到系统中的“是否作返款票使用”设置。 只有这种类型的票,才能被“返款余额支付”。 “1”表示是,其他值表示否。 |
string |
None. |
Response Formats
application/json, text/json
[
{
"productid": "sample string 1",
"productname": "sample string 2",
"theaterid": "sample string 3",
"theatername": "sample string 4",
"sceneid": "sample string 5",
"scenename": "sample string 6",
"scenenstarttime": "sample string 7",
"scenenendtime": "sample string 8",
"ticketdate": "sample string 9",
"enablecount": 10,
"unit": "sample string 11",
"price": 12.0,
"conditionsofsale": "sample string 13",
"minimum": 14,
"maximum": 15,
"singleidmaximum": 16,
"preorderdays": 17,
"webpredays": 18,
"needname": "sample string 19",
"perpersonperticket": "sample string 20",
"isnormalticket": "sample string 21",
"isrebateticket": "sample string 22"
},
{
"productid": "sample string 1",
"productname": "sample string 2",
"theaterid": "sample string 3",
"theatername": "sample string 4",
"sceneid": "sample string 5",
"scenename": "sample string 6",
"scenenstarttime": "sample string 7",
"scenenendtime": "sample string 8",
"ticketdate": "sample string 9",
"enablecount": 10,
"unit": "sample string 11",
"price": 12.0,
"conditionsofsale": "sample string 13",
"minimum": 14,
"maximum": 15,
"singleidmaximum": 16,
"preorderdays": 17,
"webpredays": 18,
"needname": "sample string 19",
"perpersonperticket": "sample string 20",
"isnormalticket": "sample string 21",
"isrebateticket": "sample string 22"
}
]
application/xml, text/xml
<ArrayOfProducts2 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface">
<Products2>
<conditionsofsale>sample string 13</conditionsofsale>
<enablecount>10</enablecount>
<isnormalticket>sample string 21</isnormalticket>
<isrebateticket>sample string 22</isrebateticket>
<maximum>15</maximum>
<minimum>14</minimum>
<needname>sample string 19</needname>
<perpersonperticket>sample string 20</perpersonperticket>
<preorderdays>17</preorderdays>
<price>12</price>
<productid>sample string 1</productid>
<productname>sample string 2</productname>
<sceneid>sample string 5</sceneid>
<scenename>sample string 6</scenename>
<scenenendtime>sample string 8</scenenendtime>
<scenenstarttime>sample string 7</scenenstarttime>
<singleidmaximum>16</singleidmaximum>
<theaterid>sample string 3</theaterid>
<theatername>sample string 4</theatername>
<ticketdate>sample string 9</ticketdate>
<unit>sample string 11</unit>
<webpredays>18</webpredays>
</Products2>
<Products2>
<conditionsofsale>sample string 13</conditionsofsale>
<enablecount>10</enablecount>
<isnormalticket>sample string 21</isnormalticket>
<isrebateticket>sample string 22</isrebateticket>
<maximum>15</maximum>
<minimum>14</minimum>
<needname>sample string 19</needname>
<perpersonperticket>sample string 20</perpersonperticket>
<preorderdays>17</preorderdays>
<price>12</price>
<productid>sample string 1</productid>
<productname>sample string 2</productname>
<sceneid>sample string 5</sceneid>
<scenename>sample string 6</scenename>
<scenenendtime>sample string 8</scenenendtime>
<scenenstarttime>sample string 7</scenenstarttime>
<singleidmaximum>16</singleidmaximum>
<theaterid>sample string 3</theaterid>
<theatername>sample string 4</theatername>
<ticketdate>sample string 9</ticketdate>
<unit>sample string 11</unit>
<webpredays>18</webpredays>
</Products2>
</ArrayOfProducts2>