API声明

Introduction

游宝星电子门票交易API是用于提供给官方网站、官方微信、官方APP、OTA电商、旅行社或其他第三方完成电子门票下单、支付、获得过闸凭证、撤单、查询订单等功能的应用程序开发接口。该软件系统先后有V1.0,V2.0,V3.0,V4.0四个版本，前三个版本均基于Asp.Net WebForms技术建造；V4.0基于Asp.Net Web Api2和Asp.Net WebForms技术建造。各版本均基本实现了向下兼容。

SeatAreaList

获取某个场次可以选座的座位区域列表及座位区域的余票数此API存在于V2.0-V4.0版本。为向下兼容,同功能的WebForms接口访问地址为~/Source/QuerySeatAreaList.aspx

API	Description
GET api/SeatArea?senceid={senceid}&triplebillid={triplebillid}	获取场次的座位区域列表及座位区域的空余座位数。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/SeatArea/Name/{seatareaid}	获取某个座位区域的名称。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

Products2

获取演艺剧场产品（门票）列表。此API存在于V2.0-V4.0所有版本。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetProducts2.aspx

API	Description
GET api/Products2?startdate={startdate}&enddate={enddate}&seatareaid={seatareaid}&theatreid={theatreid}&senceid={senceid}&tripbillcode={tripbillcode}	获取演艺剧场产品（门票）列表。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

PayOrder

对订单执行预订金支付或返款余额支付的函数集。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。包括“使用预订金+支付密码进行支付”、“使用预订金+验证码进行支付”、“使用返款余额+验证码进行支付”、“使用返款余额+支付密码”进行支付四个功能。当前接口的功能均有向下兼容（Web窗体aspx(V3.3及以前版本））的接口。

API	Description
POST api/PayOrder/UsePrepaymentAndPassword	使用预订金+支付密码对订单执行支付。向下兼容,同功能的WebForms接口访问地址为~/Source/UseAccountToPayByPwd.aspx。
POST api/PayOrder/UsePrepaymentAndVerifyCode	使用预付款和手机验证码支付订单。向下兼容,同功能的WebForms接口访问地址为~/Source/UseAccountToPayByPwd.aspx。
POST api/PayOrder/UseRebateAndPassword	使用支付密码+返款余额对订单进行支付。向下兼容,同功能的WebForms接口访问地址为~/Source/seAccountToPayByFKWithPwd.aspx。
POST api/PayOrder/UseRebateAndVerifyCode	使用返款账户余额和手机验证码支付订单向下兼容,同功能WebForms接口为。

SenceList

获取近期场次安排及各场次的空余座位情况。此API存在于V2.0-V4.0版本。为向下兼容,同功能的WebForms接口访问地址为Source/QueryTheaterSenceList.aspx

API	Description
GET api/SenceList?theatreid={theatreid}&startdate={startdate}&enddate={enddate}&theatricalid={theatricalid}	获取近期场次安排及各场次的空余座位情况。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/SenceList/{senceid}	获取某个场次安排及各场次的空余座位情况。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

OrderAndPay

对景区类供应商（含分时段和不分时段）发起预定并使用预订金或返款余额对订单执行支付。将预订和支付封装在同一个事务中，确保同时成功或失败，是代理商接口最佳操作。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

API	Description
POST api/OrderAndPay/WithPrepayment	对景区类供应商发起预定（不论是否分时段均使用此API）并使用支付密码+预订金对订单执行支付。此API相当于在同一个事务中分别调用AddOrder和UsePrepaymentWithPasswordToPay两个接口。
POST api/OrderAndPay/WithRebate	对景区类供应商发起预定（不论是否分时段均使用此API）并使用支付密码+返款余额对订单执行支付。此API相当于在同一个事务中分别调用AddOrder和UseRebateWithPasswordToPay两个接口。。

PayChannel

从电子门票系统中获取官方认可的即时支付支付渠道。即时支付：指支付宝、微信、银联网上支付等支付渠道，它们不同于预订金、返款余额支付，由游客在下单时直接向景区指定的渠道执行支付。此功能在代理商（OTA或旅行社）执行接口时，一般不使用。此API存在于V1.0-V4.0版本，为向下兼容,同功能的WebForms接口访问地址为~/Source/GetPayChannel.aspx

API	Description
GET api/PayChannel	从电子门票系统中获取官方认可的即时支付支付渠道。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

BeginToPay

对某个订单发起支付（仅指第三方即时支付，如支付宝、微信、银联等）。这个接口将您的请求，依据系统中设置的收款账号等参数，编写新的请求后Redirect到支付平台。此API存在于V1.0-V4.0版本，为向下兼容,同功能的WebForms接口访问地址为~/Source/ BeginToPay.aspx

API	Description
POST api/Order/BeginToPay/Phone	在手机网站或者微信公众号里对某个订单发起支付（仅指第三方即时支付，如支付宝、微信、银联等）。注意：入口为BeginToPayPhone的仅针对手机网站调用认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。手机网站第三方支付从T_SYS_ZFQD中取值 1，支付宝手机网站参数约定：Parm1：私钥、Parm2：公钥、Parm3：Appid、SKZH不能为空 2，微信支付手机网站参数约定
POST api/Order/BeginToPay	在电脑网页上发起对某个订单发起支付（仅指第三方即时支付，如支付宝、微信、银联等）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

API

Description

POST api/Order/BeginToPay/Phone

在手机网站或者微信公众号里对某个订单发起支付（仅指第三方即时支付，如支付宝、微信、银联等）。注意：入口为BeginToPayPhone的仅针对手机网站调用认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。手机网站第三方支付从T_SYS_ZFQD中取值 1，支付宝手机网站参数约定：Parm1：私钥、Parm2：公钥、Parm3：Appid、SKZH不能为空 2，微信支付手机网站参数约定

POST api/Order/BeginToPay

在电脑网页上发起对某个订单发起支付（仅指第三方即时支付，如支付宝、微信、银联等）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

BeginToPayWithJsapi

在微信公众号里面，使用微信JSAPI支付时，调用这个接口。HAWK认证。

API	Description
POST api/Order/BeginToPay/Jsapi	使用JSAPI支付的代码
POST api/Order/BeginToPay/ABCJsapi	农行微信支付使用JSAPI支付的代码

Refund

退票办理。 V4.0 为向下兼容,同功能的WebForms接口访问地址为~/Source/RefundTicket.aspx。

API	Description
POST api/Order/Refund	申请退款（仅当订单处于支付完成，但因门票系统原因没有生成对应的过闸凭证时可以调用（订单此时处于“已支付”，“预订金支付授权”，“返款余额支付授权状态”，一般都用不上这个功能），绝大多数情况下，需要调用RefundTicket接口，办理退票）,此操作为不可逆操作。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
POST api/Order/RefundTicket	退票申请（将订单中的一个或多个门票申请退票，申请退票后，不能撤消退票申请[不可逆操作]，只能等待供应商办理退款）。使用预订金支付、返款余额支付的，申请退票时将同时办结；即时支付时需等待供应商办理退款）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

API

Description

POST api/Order/Refund

申请退款（仅当订单处于支付完成，但因门票系统原因没有生成对应的过闸凭证时可以调用（订单此时处于“已支付”，“预订金支付授权”，“返款余额支付授权状态”，一般都用不上这个功能），绝大多数情况下，需要调用RefundTicket接口，办理退票）,此操作为不可逆操作。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

POST api/Order/RefundTicket

退票申请（将订单中的一个或多个门票申请退票，申请退票后，不能撤消退票申请[不可逆操作]，只能等待供应商办理退款）。使用预订金支付、返款余额支付的，申请退票时将同时办结；即时支付时需等待供应商办理退款）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

WeChatSingleRefund

微信退款办理的控制器

API	Description
POST api/Order/WeChatSingleRefund	微信自动退款

GlobalSetting

获取全局参数取值的控制器

API	Description
GET api/GetGlobalSetting?paramName={paramName}	获取系统全局参数的取值

Order

发起景区类供应商(不论是否分时段)的预订，发起演艺（影院）类供应商的预订。取消处于预订中的订单。查询订单详细信息，查询订单主记录，查询订单明细记录，查询订单违约手续费，查询订单列表，查询订单手续费、退款列表等。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。此API存在于V1.0-V4.0所有版本。

API	Description
POST api/Order/CancelOrder	取消预订单(发起预订后，以任何形式完成支付前，订单处于预订中状态，可以使用此接口撤消订单)。
POST api/Order/AddOrder	对景区类供应商发起预订的接口（包括分时段和不分时段的模式）。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderProducts.aspx
POST api/Order/AddOrder2	对演艺类供应商发起预订的接口。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderProducts2.aspx
GET api/Order/Query?orderid={orderid}&sendid={sendid}&personalid={personalid}	查询一个订单的详细信息，当前API相当于调用"api/Order/Main、api/Order/Detail、api/Order/Logs、api/Order/Fees"之和。仅当这个订单是您发起预订的，才会有数据返回。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryOrder.aspx
GET api/Order/Query/Main/{orderid}?personalid={personalid}	依据订单号查询一个订单的主记录（返回参数中的明细记录的集合均为空）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Main/{orderid}/{personalid}	依据订单号查询一个订单的主记录（返回参数中的明细记录的集合均为空）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Main?orderid={orderid}&sendid={sendid}&personalid={personalid}	依据订单号或接口方业务单据号查询一个订单的主记录（返回参数中的明细记录的集合均为空）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Main/{orderid}/{sendid}/{personalid}	依据订单号或接口方业务单据号查询一个订单的主记录（返回参数中的明细记录的集合均为空）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Ticket/CheckRecords/{orderid}/{ticketcode}	查询某个门票的过闸记录。
GET api/Order/Query/Detail/{orderid}?personalid={personalid}	依据订单编号，查询订单的明细记录集。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Detail/{orderid}/{personalid}	依据订单编号，查询订单的明细记录集。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Deal/{orderid}?personalid={personalid}	依据订单编号，查询订单的交割记录集。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Deal/{orderid}/{personalid}	依据订单编号，查询订单的交割记录集。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Logs/{orderid}?personalid={personalid}	依据订单号，查询这个订单的操作日志（事件的记录及这些事件的回调情况）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Logs/{orderid}/{personalid}	依据订单号，查询这个订单的操作日志（事件的记录及这些事件的回调情况）。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Fees/{orderid}?personalid={personalid}	依据订单号，查谒这个订单的退款(手续费扣除及退款)记录。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Query/Fees/{orderid}/{personalid}	依据订单号，查谒这个订单的退款(手续费扣除及退款)记录。仅当这个订单是您发起预订的，才会有数据返回。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/AllOrderFees?startdate={startdate}&enddate={enddate}&pageindex={pageindex}&orderid={orderid}&sendid={sendid}&status={status}&productid={productid}&personalid={personalid}	以分页方式查询订单退款清单（用于代理商对账）。
GET api/Order/QueryWJM?dwlx={dwlx}&dwid={dwid}&username={username}&hyid={hyid}&orderid={orderid}&ticketid={ticketid}	获取二维码图片的文件名。此函数为api/Ticket/Resource/String/{ticketcode}和api/Ticket/Resource/{ticketcode}的前置函数，查询所得的文件名为上述两个函数的输入{ticketcode}。在执行这个方法时，系统将进行“可见范围”验证（谁的订单，谁有权查看）。api/Ticket/Resource/String和api/Ticket/Resource是没有“可见范围”验证的。
GET api/Order/QueryTax?dwlx={dwlx}&dwid={dwid}&username={username}&hyid={hyid}&orderid={orderid}	查询一票制订单的开票发票二维码信息注：该开票二维码暂时针对天门狐仙、宝峰湖在系统全局参数中启用了一票制发票服务时才有返回
GET api/Order/CheckIdentificationNumber	核查订单中某种门票类型的某个身份证号码是否可用预订
GET api/Order/CheckIdentificationNumber/Singel?productid={productid}&idCodeList={idCodeList}	核查订单中某种门票类型的某个身份证号码是否可用预订
GET api/Order/AllOrders?pageindex={pageindex}&startdate={startdate}&enddate={enddate}&dateref={dateref}&orderid={orderid}&sellbillid={sellbillid}&senderid={senderid}&mobile={mobile}&creidnum={creidnum}&status={status}&personalid={personalid}	订单概要统计数据接口。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryOrdersList.aspx（新版本接口有更好的可读性）。
GET api/Order/Tickets?orderid={orderid}&senderid={senderid}&personalid={personalid}	获取门票清单。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetTicketList.aspx 。
GET api/Order/Tickets/{orderid}?senderid={senderid}&personalid={personalid}	获取门票清单。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetTicketList.aspx 。
GET api/Order/Tickets/{orderid}/{senderid}?personalid={personalid}	获取门票清单。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetTicketList.aspx 。
GET api/Order/Tickets/{orderid}/{senderid}/{personalid}	获取门票清单。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetTicketList.aspx 。
GET api/Order/Ticket?ticketid={ticketid}&orderid={orderid}&senderid={senderid}&personalid={personalid}	某取某一个特定的门票。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Ticket/{ticketid}?orderid={orderid}&senderid={senderid}&personalid={personalid}	某取某一个特定的门票。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Ticket/{ticketid}/{orderid}?senderid={senderid}&personalid={personalid}	某取某一个特定的门票。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Ticket/{ticketid}/{orderid}/{senderid}?personalid={personalid}	某取某一个特定的门票。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Order/Ticket/{ticketid}/{orderid}/{senderid}/{personalid}	某取某一个特定的门票。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

Agent

代理商有关的接口。包括修改密码、修改支付密码、取得验证码、从官方渠道登陆等。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码）），注意，本接口下个别接口是有不同的。

API	Description
POST api/Agent/ChangeLoginPassword/UseVerifyCode	使用验证码重置登陆密码。认证方式:HAWK，密钥：KEY(注意，这个是与其他方法稍有不同的)。
POST api/Agent/ChangeLoginPassword/UseOldPwd	代理商使用旧密码修改登陆密码。
POST api/Agent/VerifyCode	发送一个验证把到代理商留存在供应商处的手机上。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
POST api/Agent/AgentIsVerifyCode	代理商未登录发送一个验证把到代理商留存在供应商处的手机上。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
POST api/Agent/CheckAccountName	从登录界面重置密码时验证该用户名是否正确
POST api/Agent/LoginFromOffcialSite	通过官方网站对代理商用户进行嵌套登陆，获取代理商会话所需的KEY。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））(这个使用的是特定用户，代理商无法访问)。
POST api/Agent/ChangePayPassword	使用验证码更改支付密码。

ProviderConfig

获取供应商参数、设置供应商处的参数。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。当前接口的功能均有向下兼容（Web窗体aspx(V3.3及以前版本））的接口。

API	Description
GET api/ProviderConfig	获取供应商参数设置。向下兼容,同功能的WebForms接口访问地址为Source/GetProviderConfig.aspx。
POST api/ProviderConfig	设置供应商处的参数。向下兼容,同功能的WebForms接口访问地址为Source/SetAgentParameters.aspx。

Personal

个人用户的相关操作，包括个人用户的登陆，获取验证码，修改密码，更改个人用户信息，绑定多个账户等。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））(这个使用的是特定用户，代理商无法访问)。

API	Description
POST api/Personal/Login/WithUserName	个人用户使用用户名和密码登陆。
POST api/Personal/Regist	个人用户的注册。HAWK认证，仅限官方网络，代理商不可访问。
POST api/Personal/Login/WithOpenId	个人用户使用微信OPENID登陆，如果当前OpenId没有注册，则直接完成注册。
POST api/Personal/Login/WithVerifyCode	个人用户使用手机号+验证码登陆，如果尚未注册，则直接注册。
POST api/Personal/VerifyCode	给某个手机号(个人用户)发送一个验证码。
POST api/Personal/CheckUserNameUseable	检查某个用户名是否可以用于（个人用户）注册。V4.0接口，没有向下兼容接口，HAWK认证，仅限官方网络，代理商不可访问。
GET api/Personal/Info/{username}	依据用户名获取当前用户的一般信息，HAWK认证，仅限官方网络，代理商不可访问。
GET api/Personal/InfoByid/{memberid}	依据用户ID获取当前用户的一般信息，HAWK认证，仅限官方网络，代理商不可访问。
POST api/Personal/CheckMobileUseable	检查某个手机号是否可以用于（个人用户）注册。V4.0接口，没有向下兼容接口，HAWK认证，仅限官方网络，代理商不可访问。
POST api/Personal/Login/ResetPassword	使用手机号+验证码的模式重置个人用户密码。V4.0接口，没有向下兼容接口，HAWK认证，仅限官方网络，代理商不可访问。
POST api/Personal/Login/ChangePassword	使用旧密码更改个人用户密码。V4.0接口，没有向下兼容接口，HAWK认证，仅限官方网络，代理商不可访问。

NHWeChatRefund

农行微信退款

API	Description
POST api/Order/NHWeChatSingleRefund	农行微信自动退款

Report

用于查询报表数据的控制器

API	Description
GET api/Report/QueryInternetReserveReport?startdate1={startdate1}&enddate1={enddate1}&startdate2={startdate2}&enddate2={enddate2}&orderid={orderid}&ticketid={ticketid}	查询互联网预定汇总报表数据
GET api/Report/QueryInternetTicketReport?startdate1={startdate1}&enddate1={enddate1}&startdate2={startdate2}&enddate2={enddate2}&orderid={orderid}&ticketid={ticketid}	查询互联网售票汇总表分门票类型数据
GET api/Report/GetRefundTime	获取退票截止时间

AlipayRefundNoPwd

即时支付批量退款（无密）

API	Description
POST api/Order/AlipayRefundNoPwd	即时支付批量退款（无密）。

TheatricalList

获取当前正在演出（排片）剧目列表（影片列表）。在V4.0新增。没有对应的WEBForms接口。

API	Description
GET api/Theatrical	获取当前正在演出（排片）剧目列表（影片列表）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/Theatrical/{theatricalid}	获取指定代码的剧目（影片)信息。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/GetScenicSpots	景区版客户端获取景区介绍

TripBill

行程单接口 V4.0接口，这个接口在前面的版本中是不存在的。在编写本文时此，此功能还只能用于张家界市和张家界周边的地市。

API	Description
GET api/TripBill/{billid}	从服务器获取一个已下载的行程单认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
POST api/TripBill?billid={billid}&stroketype={stroketype}&registrationtype={registrationtype}&teamnumber={teamnumber}&code={code}	从一程通同步一个行程单的信息认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/GetJGJGList	获取配置文件“监管机构”

RebateAccount

返款账户信息与交易记录查询接口。 V4.0接口。

API	Description
GET api/Agent/Rebate?year={year}	返回返款账户的信息，因返款账户总是以年度为单位组织，因此会返回一个集合。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryFKRec.aspx。
GET api/Agent/Rebate/TradeRecords?startdate={startdate}&pageindex={pageindex}&year={year}&enddate={enddate}&tradetype={tradetype}	查询返款账户交易记录。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryFKJYRec.aspx。

ServiceList

从景区类供应商获到服务项目列表（旅游线路列表）的API。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetServiceItem.aspx

API	Description
GET api/ServiceList	检索景区类供应商旅游线路（服务项目）清单。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/ServiceList/{servicecode}	检索景区类供应商指定代码的服务项目认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

OrderAndPay2

对演艺剧场(含影院)类供应商发起预定并使用预订金或返款余额对订单执行支付。将预订和支付封装在同一个事务中，确保同时成功或失败，是代理商接口最佳操作。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

API	Description
POST api/OrderAndPay2/WithPrepayment	对演艺剧场类供应商发起预定并使用支付密码+预订金对订单执行支付。此API相当于在同一个事务中分别调用AddOrder2和api/PayOrder/UsePrepaymentAndPassword两个接口。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderAndPayWithYDJ2.aspx。
POST api/OrderAndPay2/WithRebate	对演艺剧场类供应商发起预定并使用支付密码+预订金对订单执行支付。此API相当于在同一个事务中分别调用AddOrder2和api/PayOrder/UseRebateAndPassword两个接口。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderAndPayWithFK2.aspx。

SeatStatus

查询座位表、座位状态的接口。此API存在于V2.0-V4.0版本。

API	Description
GET api/Seats/Status?senceid={senceid}&seatareaid={seatareaid}	查询某个场次、某个座位区域的座位状态，用于刷新客户端给客人展示的座位图认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QuerySeatsState.aspx。
GET api/Seats/Status/{senceid}/{seatareaid}	查询某个场次、某个座位区域的座位状态，用于刷新客户端给客人展示的座位图认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QuerySeatsState.aspx。
GET api/Seats?seatareaid={seatareaid}	查询某个座位区域的座位行和座位。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryRowsAndSeatsList.aspx。
GET api/Seats/{seatareaid}	查询某个座位区域的座位行和座位。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryRowsAndSeatsList.aspx。

TicketImage

API	Description
GET api/Ticket/Image/{orderid}/{ticketcode}	获取手机二维码门票的图片（这个图片在手机上显示之后，可以直接用于检票）。本API将较验访问者对订单的访问权限，不要求执行前置的api/Order/QueryWJM获取文件名。本API是实时API，订单一支付可立即调用。
GET api/Ticket/Barcode/String/{orderid}/{ticketcode}	获取门票二维码二维码字符串。本API将较验访问者对订单的访问权限，不要求执行前置的api/Order/QueryWJM获取文件名。本API是实时API，订单一支付可立即调用。
GET api/Ticket/Resource/String/{ticketcode}	获取门票二维码字符串。
GET api/Ticket/Resource/{ticketcode}	获取门票图片

TheatreList

获取系统中所有剧场列表。此API存在于V2.0-V4.0所有版本。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryTheatreList.aspx

API	Description
GET api/QueryTheatreList/api/TheatreList	获取系统中所有剧场列表。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。
GET api/QueryTheatreList/api/TheatreList/{theatreid}	获取系统中指定ID的剧场。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。

TimeSegment

获取供应商电子门票时段分配表。仅在供应商启用时段设置时，此函数才可以被调用。 V4.0接口。

API	Description
GET api/TimeSegment?startdate={startdate}&enddate={enddate}&servicecode={servicecode}	获取供应商电子门票时段分配表。仅在供应商启用时段设置时，此函数才可以被调用。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetTimeSegment.aspx。

Products

从景区获取可以预定（预购）的产品（门票）列表（包括分时段和不分时段的模式），获取产品的库存信息。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。此API存在于V1.0-V4.0所有版本。为向下兼容,同功能的WebForms接口访问地址为~/Source/GetProducts.aspx

API	Description
GET api/Products?startdate={startdate}&enddate={enddate}&servicecode={servicecode}&tripbillcode={tripbillcode}	从景区获取可以预定（预购）的产品（门票）列表（包括分时段和不分时段的模式）
GET api/Products/Inventory?startdate={startdate}&enddate={enddate}&productid={productid}&servicecode={servicecode}	从景区获取可以预定（预购）的产品（门票）列表（包括分时段和不分时段的模式）为向下兼容,同功能的WebForms接口访问地址为~/Source/GetProductsInventory.aspx。

NHAliPayRefund

农行支付宝的退款办理

API	Description
POST api/Order/NHAliPaySingleRefund	农行微信自动退款

Prepayment

预订金账户信息(余额)查询接口。 V4.0接口。

API	Description
GET api/Agent/Prepayment	查询预订金账户余额（基本信息）。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryYFKRec.aspx。
GET api/Agent/Prepayment/TradeRecords?startdatetime={startdatetime}&enddatetime={enddatetime}&pageindex={pageindex}&tradetype={tradetype}	查询预订金账户交易记录。认证方式:HAWK，密钥：KEY+UPPER（MD5（密码））。为向下兼容,同功能的WebForms接口访问地址为~/Source/QueryYFKJYRec.aspx