GET api/Products?startdate={startdate}&enddate={enddate}&servicecode={servicecode}&tripbillcode={tripbillcode}

从景区获取可以预定(预购)的产品(门票)列表(包括分时段和不分时段的模式)

请求信息

URI参数

NameDescriptionTypeAdditional information
startdate

计划的出行起始日期,可以为空,为空时表示当天,格式YYYYMMDD

string

Default value is

enddate

计划的出行截止日期,可以为空,为空时表示当天后的第七天,格式YYYYMMDD

string

Default value is

servicecode

(可选)线路ID,仅在分时段景区中这个项。非分时段的景区将不理会这个参数。在分时段景区系统指定这个参数时,将仅返回对应线路的门票类型。

string

Default value is

tripbillcode

(可选)行程单号或行程单条码内容(仅用于张家界团队)

string

Default value is

窗体参数

None.

回复信息

资源描述

从景区获取可以预定(预购)的产品(门票)列表(包括分时段和不分时段的模式)

Collection of Products
NameDescriptionTypeAdditional information
productid

产品ID,通常为一个GUID值的string值(VARCHAR36),同门票系统中的“门票类型ID”,不会为空。

string

None.

productname

产品名称,同门票系统中的“门票类型名称”,不会为空。

string

None.

unit

单位,通常为"张",但也有可能为“份”,不能折散销售的大套票可能为“份”

string

None.

price

价格,此值恒大于等于0

decimal number

None.

initdate

有效起始日期,格式YYYYMMDD,此值主要用于区分淡旺季,指明当前票种从何日开始售起

string

None.

enddate

有效截止日期,格式YYYYMMDD,此值主要用于区分淡旺季,指明当前票种售至何日止

string

None.

conditionsofsale

出售条件,有1至8个选项

string

None.

minimum

最小单笔出售数量,0表示没有限制

integer

None.

maximum

最大单笔出售数量,0 表示没有限制,正整数表示当前票种,所有渠道可售量之和

integer

None.

singleidmaximum

单ID日最大购买限制,0表示没有限制,正整数表示前票种每个代理商可以销售的最大量

integer

None.

preorderdays

当前票种有效时长,1日有效(使用当天有效)为1,2日有效为2,依此类推

integer

None.

effectbegperiod

生效起始周期,MMDD ,此值主要用于区分淡旺季,前面initdate和enddate是已经经过运算,折算成了当前时间至对应截止日期的值,此处是未经过运算,在门票系统的设置值

string

None.

effectendperiod

生效截止周期MMDD ,此值主要用于区分淡旺季

string

None.

effectperiodnegated

生效周期取反,“1”表示一年中除effectbegperiod至effectendperiod是有效的

string

None.

webpredays

互联网预定提前日数:此值为0表示,当天订,当天可以使用;此值为1表示必须提前一天及以上预订;2表示必须提前两天及以上预定,依此类推。

integer

None.

needname

实名制约束,"1"表示必须一个证件号一张门票,“0”表示不需要实名制

string

None.

timesegmenttype

时段资源类型,1是占用网络票资源,2是占用前台资源。

string

None.

perpersonperticket

是否一人一票,“1”表示一人一票。

string

None.

回复格式

Test application/json, text/json

Sample:
[
  {
    "productid": "sample string 1",
    "productname": "sample string 2",
    "unit": "sample string 3",
    "price": 4.0,
    "initdate": "sample string 5",
    "enddate": "sample string 6",
    "conditionsofsale": "sample string 7",
    "minimum": 8,
    "maximum": 9,
    "singleidmaximum": 10,
    "preorderdays": 11,
    "effectbegperiod": "sample string 12",
    "effectendperiod": "sample string 13",
    "effectperiodnegated": "sample string 14",
    "webpredays": 15,
    "needname": "sample string 16",
    "timesegmenttype": "sample string 17",
    "perpersonperticket": "sample string 18"
  },
  {
    "productid": "sample string 1",
    "productname": "sample string 2",
    "unit": "sample string 3",
    "price": 4.0,
    "initdate": "sample string 5",
    "enddate": "sample string 6",
    "conditionsofsale": "sample string 7",
    "minimum": 8,
    "maximum": 9,
    "singleidmaximum": 10,
    "preorderdays": 11,
    "effectbegperiod": "sample string 12",
    "effectendperiod": "sample string 13",
    "effectperiodnegated": "sample string 14",
    "webpredays": 15,
    "needname": "sample string 16",
    "timesegmenttype": "sample string 17",
    "perpersonperticket": "sample string 18"
  }
]

Test application/xml, text/xml

Sample:
<ArrayOfProducts xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TourWebApi.Models.Result">
  <Products>
    <conditionsofsale>sample string 7</conditionsofsale>
    <effectbegperiod>sample string 12</effectbegperiod>
    <effectendperiod>sample string 13</effectendperiod>
    <effectperiodnegated>sample string 14</effectperiodnegated>
    <enddate>sample string 6</enddate>
    <initdate>sample string 5</initdate>
    <maximum>9</maximum>
    <minimum>8</minimum>
    <needname>sample string 16</needname>
    <perpersonperticket>sample string 18</perpersonperticket>
    <preorderdays>11</preorderdays>
    <price>4</price>
    <productid>sample string 1</productid>
    <productname>sample string 2</productname>
    <singleidmaximum>10</singleidmaximum>
    <timesegmenttype>sample string 17</timesegmenttype>
    <unit>sample string 3</unit>
    <webpredays>15</webpredays>
  </Products>
  <Products>
    <conditionsofsale>sample string 7</conditionsofsale>
    <effectbegperiod>sample string 12</effectbegperiod>
    <effectendperiod>sample string 13</effectendperiod>
    <effectperiodnegated>sample string 14</effectperiodnegated>
    <enddate>sample string 6</enddate>
    <initdate>sample string 5</initdate>
    <maximum>9</maximum>
    <minimum>8</minimum>
    <needname>sample string 16</needname>
    <perpersonperticket>sample string 18</perpersonperticket>
    <preorderdays>11</preorderdays>
    <price>4</price>
    <productid>sample string 1</productid>
    <productname>sample string 2</productname>
    <singleidmaximum>10</singleidmaximum>
    <timesegmenttype>sample string 17</timesegmenttype>
    <unit>sample string 3</unit>
    <webpredays>15</webpredays>
  </Products>
</ArrayOfProducts>