第三方OTA对接小游（剧院）

| 日期 | 修订 | 操作人 |
| --- | --- | --- |
| 2022-06-07 | 增加查询价格和库存 | 钟鸣 |
| 2023-07-14 | 增加产品列表 | 钟鸣 |
| 2023-07-17 | 增加剧院获取场次和座位 | 钟鸣 |

第三方售票接口地址（其中XXXXXX测试通过后才确定）
http://cloud.et0731.com/api/holds/ota/index/compid/XXXXXX/type/ Xiaoyou/method/index.html
测试地址
http://ttest.et0731.com/api/holds/ota/index/compid/10085/type/Xiaoyou/method/index.html

接口appid：779540b33ea74bf320cac6d7bbee4b20
接口appsecret: d49d47373b17ce7a8eaaaccd86a2b3b6
测试产品ID：1000007

请求方式POST
数据方式：Content-Type: application/json; charset=UTF-8
==注：为了避免json解析的可能存在误差，数值使用字符串形式，是否用1与0表示，汉字不进行转义==

### 请求公共参数

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| appid | string | 是 | 商户appid | xxxxxxxx |
| serviceName | String | 是 | 请求服务名称 | CreateOrder创建订单RefundOrder订单退款…|
| data | Object | 是 | 请求数据 | {…请求的数据结构体接口**参数仅介绍此参数**}|

### 回复公共参数

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| appid | string | 是 | 商户appid | xxxxxxxx |
| code | int | 是 | 返回操作结果 | 1为成功，其他为失败 |
| msg | String | 是 | 请求返回的信息 | 请求成功 |
| data | Object | 是 | 请求成功返回的内容 | {…返回的数据结构体**接口参数仅介绍此参数**}|

### 获取ota产品列表
serviceName：GetProductList
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| page | int | 是 | 页码 | 1 |
| pagesize | int | 是 | 分页大小 | 20 |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| 
| sign | string | 是 | 签名结果 | xxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| current_page | int | 是 | 当前页码 | 1 |
| total | int | 是 | 产品总页数 | 2 |
| last_page | int | 是 | 最后一页页码 | 2 |
| per_page | int | 是 | 分页大小 | 20 |
| data | Array | 是 | 产品列表数据 | [{id:产品IDproduct_name:产品名称specs_name:规格名称description:规格描述detail:产品详情by_notice:购买须知agreement:消费说明（使用协议）tag:标签service:服务cost:成本价cut_price:划线价price:售价dtstart:开始销售时间（空为不限）dtend:结束销售时间（空为不限）}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxx |

### 获取剧场场次
serviceName：GetSessionList
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 描述 |
| --- | --- | --- | --- | --- |
| day | string | 是 | 日期 | 2023-07-17 |
| PLU | string | 是 | 小游子票ID | 100851000907 |
| 4# | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| 
| sign | string | 是 | 签名结果 | xxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| list | Array | 是 | 剧院场次列表数据 | [{id:场次IDtitle:场次名称start:开场时间end:闭幕时间}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxx |

### 获取剧场座位信息
serviceName：GetSeatInfo
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| day | string | 是 | 日期 | 2023-07-17 |
| sessionid | int | 是 | 场次ID | 391 |
| PLU | string | 是 | 小游子票ID | 100851000907 |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| product_name | string | 是 | 小游子票产品名称 | 某某门票 |
| specs_name  | string | 是 | 下游子票规格名称 | 贵宾票 |
| stock | int | 是 | 座位剩余数量 | 888 |
| list | Array | 是 | 剧院场次列表数据 | [{color:座位标色grade:分区IDseatno:座位号state:状态：1可用，其他不可用}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

### 创建订单
serviceName：CreateOrder
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| otaOrderId | string | 是 | 第三方售票端订单号 | 202106031334898888 |
| items | Array | 是 | 订单产品信息 | [{itemId: 第三方售票端子订单IDPLU:小游子票IDprice:价格num:数量grade:剧场分区（非剧场传0）sessionid:剧场场次ID（非剧场传0）seatno:剧场座位号（非剧场传空）needcard:是否实名useStartDate:使用开始时间useEndDate:使用结束时间 passengers:[…{name:姓名cardNo:身份证mobile:手机}]}…] |
| contacts | object | 是 | 购票人信息 | {name:姓名mobile：手机} |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| otaOrderId | string | 是 | 第三方售票端订单号 | 202106031334898888 |
| supplierOrderId | string | 是 | 小游平台的订单号（取票码） | 10001595 |
| tickets | Array | 是 | 入场二维码内容列表 | [{code:过闸码,name:游客名称,cardNo:证件号mobile:手机}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

### 获取产品价格信息
serviceName：GetPriceList
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| startTime | string | 是 | 查询开始时间 | 2022-06-07 |
| endTime | string | 是 | 查询结束时间 | 2022-06-15 |
| PLU | string | 是 | 小游子票ID | 1000007 |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| list | Array | 是 | 所查询的每日价格列表 | [PLU: 小游子票ID,date: 日期2022-06-07,price: 建议销售价格,marketPrice: 建议划线价,costPrice: 成本价,stock: 库存-1表示不限库存] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

### 订单退订
serviceName：RefundOrder
请求方式
Post
请求来源
第三方售票端向小游平台请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| otaOrderId | string | 是 | 第三方售票端订单号 | 202106031334898888 |
| supplierOrderId | string | 是 | 3# | 10001595 |
| totalAmount | double | 是 | 退款金额 | 1.00 |
| items | Array | 是 | 订单产品信息存在票号则退单票 | [{itemId: 第三方售票端子订单IDPLU:小游子票IDamount:退款金额ticketid:票号num:退订数量}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| items | Array | 是 | 第三方售票端子订单ID列表 | [xxxxxxx,xxxxxxx] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

### 订单检票核销
serviceName：OrderCheck
请求方式
Post
请求来源
小游平台向第三方售票端请求
请求data

| 参数名 | 类型 | 必填 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| otaOrderId | string | 是 | 第三方售票订单号 | 202106031334898888 |
| supplierOrderId | string | 是 | 小游平台的订单号 | 10001595 |
| items | Array | 是 | 核销票内子票内容 | [{itemId: 第三方售票端子订单IDnum:总数量useNum:使用数量code:票号}…] |
| nonce_str | string | 是 | 加密随机扰码 | xxxxxxxxxx |
| sign | string | 是 | 签名结果 | xxxxxxxxxx |

返回data

| 参数名 | 类型 | 必填 | 必填 | 示例 |
| --- | --- | --- | --- | --- |

空
data为空不需要签名。

**签名方式：**
所有的data内的数据按key的ASCII排序，忽略sign字段和值为空的字段，结构体需要转json
==其中data内容为空时候不需要签名==
按照key1=val1&key2=val2连接后，直接拼接appsecret，取md5（32位小写）结果为签名内容