@ahuawaiwai
2019-03-01T09:18:02.000000Z
字数 13888
阅读 574
测试地址:http://api.app.jinri.org.cn/swagger/
正式地址:http://api.app.jinri.cn/swagger/
接口文档
请求地址:[http://api.app.jinri.org.cn/api/v1/order/queryorderlist]
请求示例 (JSON):
{
"listStatus": "All",
"apiType": "All",
"userId": "505",
"userName": "17621673633",
"perPageCount": 5,
"currentPage": 1
}
返回示例:
{
"pageCount": 5,
"currentPage": 1,
"totalCount": 149,
"data": [
{
"orderDate": "2018-07-25",
"isCurrentYear": true,
"list": [
{
"listStatus": 0,
"apiId": 5,
"createTime": "2018-07-25 17:44:01",
"orderStatus": 5,
"payStatus": 0,
"userId": "505",
"userName": "",
"orderNo": "",
"orderId": "902",
"totalPrice": "3372.00",
"depCity": "惠灵顿",
"arrCity": "上海",
"depAirport": "惠灵顿国际机场",
"arrAirport": "浦东国际机场T1",
"depTime": null,
"arrTime": null,
"title": null,
"tripNo": null,
"tripType": 1,
"remark": null,
"remark2": null,
"imgUrl":"",
"match_id":"",
"is_import":false,
"refund_reason":"",
"game_type":"",
"segments": [
{
"depTime": "2018-07-26 05:00",
"aircom": "MU",
"airLogo": "http://gjcdn.jinri.cn/static/AirLine/MU.png",
"flightNo": "东方航空QF172",
"index": 0
}
]
}
]
},
{
"orderDate": "2018-07-24",
"isCurrentYear": true,
"list": [
{
"listStatus": 0,
"apiId": 4,
"createTime": "2018-07-24 14:16:19",
"orderStatus": 5,
"payStatus": 0,
"userId": "505",
"userName": "",
"totalPrice": "0",
"orderNo": "",
"orderId": "902",
"depCity": null,
"arrCity": null,
"depAirport": null,
"arrAirport": null,
"depTime": "2018-08-21",
"arrTime": "2018-08-22",
"title": "上海悦隆酒店",
"tripNo": null,
"tripType": 0,
"remark": "1间",
"remark2": "共1晚",
"imgUrl":"",
"match_id":"",
"is_import":false,
"refund_reason":"",
"game_type":"",
"segments": null
},
{
"listStatus": 0,
"apiId": 3,
"createTime": "2018-07-24 09:46:03",
"orderStatus": 7,
"payStatus": 0,
"userId": "505",
"userName": "",
"orderNo": "",
"orderId": "902",
"totalPrice": null,
"depCity": "上海",
"arrCity": "昆山",
"depAirport": null,
"arrAirport": null,
"depTime": "2018-08-21 08:57",
"arrTime": "2018-08-21 09:35",
"title": null,
"tripNo": "K376",
"tripType": 0,
"remark": null,
"remark2": null,
"imgUrl":"",
"match_id":"",
"is_import":false,
"refund_reason":"",
"game_type":"",
"segments": null
}
]
}
],
"code": 0,
"isSuccess": false,
"message": "查询数据成功"
}
- code:int 返回码,0代表成功
- data:数据列表
- orderDate:string 分组日期
- isCurrentYear:boolean是否当年,如果是隐藏年份
- listStatus:列表订单状态
- apiId:订单接口类型
- createTime:DateTime 预定日期
- orderStatus:int 订单状态 对应具体业务状态
- payStatus:int 支付状态 仅赛事使用 0.未支付 1.已支付
- userId:string 用户ID
- userName:string 用户名
- orderNo:string 订单编号【机票、火车票、酒店】
- orderId:string 订单id 【赛事、旅游】
- totalPrice:string 总价【国内机票如果有优惠券 显示优惠后的价格】
- depCity:string 出发城市
- arrCity:string 到达城市
- depAirport:string 出发机场
- arrAirport:string 到达机场
- depTime:string 出发时间/赛事时间
- arrTime:string 到达时间
- title:string 酒店名称/赛事名称/旅游名称
- tripNo:string 火车票车次
- tripType:航程类型 【只有机票使用】
- remark:string 酒店房间数/赛事项目/旅游人数
- remark2:string 酒店几晚
- imgurl:string 图片url【旅游、赛事】
- match_id:string 存放赛事信息
- is_import:boolean 是否跑团导入【仅赛事使用】
- refund_reason:string 失败原因【仅赛事使用】
- game_type:string 比赛类型 1--马拉松 2--骑行 3--游泳比赛 4--其他比赛【仅赛事使用】
- segments:List 飞机航程 【只有机票使用】
- depTime:string 出发时间
- aircom:string 航空公司
- airLogo:string 航空公司Logo地址
- flightNo:string 航班号
- index:int 0表示去程 1表示返程
- depCity:string 出发城市
- arrCity:string 到达城市
- depAirport:string 出发机场
- arrAirport:string 到达机场
- couponAmount:string 优惠券金额
- isApplyChange : bool 是否申请改签,true代表申请
- isSuccess:bool 是否成功,true代表成功
- message: string 返回信息
- perPageCount:int 每页记录数
- currentPage:int 当前页数
- totalCount:int 总行数
请求地址:[http://api.app.jinri.org.cn/api/v1/order/deleteorder]
请求示例 (JSON):
{
"user": "JinriTrainIos",
"sign": "4116f69880ac664fd6565dbfc781f69f",
"timestamp": "1534475185418",
"sessionid": "m1LaUwC/fGbBCFshtJ2iFSryzToNc+/9++FZIFF87G8NKJEl5Qr//A==",
"requestKey": "e04dddce-dd07-4938-befd-62b22c42734a",
"data":{
"apiType": 3,
"orderNo": "17621673633"
}
}
- user string 必填
- sign string 必填
- timestamp string 必填
- sessionid string 必填
- requestKey string
- data
- apiType 必填,订单接口类型 目前只支持机票=5,火车票=3,酒店=4
- orderNo string 必填,订单编号
返回示例:
{
"data":true
"code": 0
"isSuccess":true
"message":"删除订单成功"
}
- data:bool 是否成功,true代表成功
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
请求地址:[http://api.app.jinri.org.cn/api/v1/coupon/getCouponList]
请求示例 (JSON):
{
"userId": 521,
"couponStatus": 1,
"couponType": 1,
}
返回示例:
{
"pageCount": 0,
"currentPage": 0,
"totalCount": 1,
"data": [
{
"title": "test",
"couponType": "0",
"amount": 5,
"minUseAmount": 0,
"code": "0",
"startTime": "2018-10-01 00:00:00",
"endTime": "2018-11-20 00:00:00",
"receiveWay": 0,
"amountType": 0,
"couponStatus": 1
}
],
"code": 0,
"isSuccess": true,
"message": "获取优惠券列表成功"
}
- data:数据列表
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
- perPageCount:int 每页记录数
- currentPage:int 当前页数
- totalCount:int 总行数
请求地址:[http://api.app.jinri.org.cn/api/v1/coupon/getAppCouponByEvent]
请求示例 (JSON):
{
"userId": 88,
"mobile": "15214335603",
"eventId": 1
}
- userId int 必填,用户编号
- mobile string 必填,手机号
- eventId int 必填,活动ID
返回示例:
{
"data": true,
"code": 0,
"isSuccess": true,
"message": "领取优惠券成功"
}
- data:bool 是否成功,true代表成功
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
请求地址:[http://api.app.jinri.org.cn/api/v1/coupon/getH5CouponByEvent]
请求示例 (JSON):
{
"userId": 88,
"mobile": "15214335603",
"eventId": 1
}
- userId int 必填,用户编号
- mobile string 必填,手机号
- eventId int 必填,活动ID
返回示例:
{
"data": true,
"code": 0,
"isSuccess": true,
"message": "领取优惠券成功"
}
- data:bool 是否成功,true代表成功
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
请求地址:[http://api.app.jinri.org.cn/api/v1/coupon/getEventInfoById]
请求示例 (JSON):
{
"eventId": 1
}
- eventId int 必填,活动ID
返回示例:
{
"data": {
"eventInfoData": {
"eventId": 1,
"title": "测试",
"eventStatus": 1,
"startTime": "2018-10-01 00:00:00",
"endTime": "2018-11-30 00:00:00",
"eventScope": 0,
"eventRule": "测试规则",
"isShare": 0,
"shareTitle": "测试分享",
"shareImgUrl": "http:baidu.com",
"shareContent": "测试分享内容",
"shareLinkUrl": "",
"topImgUrl_APP": "",
"topImgUrl_H5": ""
},
"couponInfoData": [
{
"title": "test",
"amountType": 0,
"amount": 5,
"minUseAmount": 0,
"totalCount": 500,
"isFinish": false,
"describe": "test describe",
"businessType": "0",
"startTime": "2018-10-01 00:00:00",
"endTime": "2018-11-20 00:00:00"
}
]
},
"code": 0,
"isSuccess": true,
"message": "活动信息获取成功"
}
- data:数据列表
- eventInfoData 活动信息
- title: string 活动标题
- eventStatus: int 活动状态
- startTime: datetime 开始时间
- endTime: datetime 结束时间
- eventScope:int 活动类型
- eventRule:string 活动规则
- eventRule:string 活动规则
- isShare: int 是否分享
- shareTitle: string 分享标题
- shareImgUrl: string 分享图片地址
- shareContent: string 分享内容
- shareLinkUrl: string 分享链接地址
- topImgUrl_APP: string APP头图地址
- topImgUrl_H5: string H5头图地址
- couponInfoData:list 优惠券信息
- title:string 优惠券信息
- amountType:int 金额类型
- amount:decimal 金额
- minUseAmount:decimal 最小使用金额
- totalCount:int 数量
- isFinish:bool 是否生成完
- describe:string 描述
- businessType:string 业务类型
- startTime: datetime 优惠券生效日期
- endTime: datetime 优惠券截止日期
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
请求地址:[http://api.app.jinri.org.cn/api/v1/coupon/getEventInfo
]
请求示例 (JSON):
{
"uid": 0,
"mobile": "string"
}
- uid int 必填,用户编号
- mobile string 必填,手机号
返回示例:
{
"data": {
"eventInfoData": {
"eventId": 1,
"title": "测试",
"eventStatus": 1,
"startTime": "2018-10-01 00:00:00",
"endTime": "2018-11-30 00:00:00",
"eventScope": 0,
"eventRule": "测试规则",
"isShare": 0,
"shareTitle": "测试分享",
"shareImgUrl": "http:baidu.com",
"shareContent": "测试分享内容",
"shareLinkUrl": "",
"topImgUrl_APP": "",
"topImgUrl_H5": ""
},
"couponInfoData": [
{
"title": "test",
"amountType": 0,
"amount": 5,
"minUseAmount": 0,
"totalCount": 500,
"isFinish": false,
"describe": "test describe",
"businessType": "0",
"startTime": "2018-10-01 00:00:00",
"endTime": "2018-11-20 00:00:00"
}
]
},
"code": 0,
"isSuccess": true,
"message": "活动信息获取成功"
}
- data:数据列表
- eventInfoData 活动信息
- title: string 活动标题
- eventStatus: int 活动状态
- startTime: datetime 开始时间
- endTime: datetime 结束时间
- eventScope:int 活动类型
- eventRule:string 活动规则
- eventRule:string 活动规则
- isShare: int 是否分享
- shareTitle: string 分享标题
- shareImgUrl: string 分享图片地址
- shareContent: string 分享内容
- shareLinkUrl: string 分享链接地址
- topImgUrl_APP: string APP头图地址
- topImgUrl_H5: string H5头图地址
- couponInfoData:list 优惠券信息
- title:string 优惠券信息
- amountType:int 金额类型
- amount:decimal 金额
- minUseAmount:decimal 最小使用金额
- totalCount:int 数量
- isFinish:bool 是否生成完
- describe:string 描述
- businessType:string 业务类型
- startTime: datetime 优惠券生效日期
- endTime: datetime 优惠券截止日期
- code:int 返回码,0代表成功
- isSuccess:bool 接口调用是否成功,true代表成功
- message: string 返回信息
请求地址:[http://apiflight.shanglv.jinri.cn/api/Change/GetOrderChangeList]
测试请求地址:[http://tweb.apiflight.jinri.cn/api/Change/GetOrderChangeList]
请求示例 (JSON):
{
"user": "AdminUser",
"sign": "71993882b3b2519f5bf09589bcbe9814",
"timestamp": "1537325992862",
"sessionid": "3k9tN+sFa32/HtB6/eoLjak+XgBEbc0viSDzU8wc4WY=",
"data": "118102961851"
}
- user string 必填
- sign string 必填
- timestamp string 必填
- sessionid string 必填
- data string 必填,订单编号
返回示例:
{
"code": 0,
"message": "成功",
"TotalRowCount": 0,
"data": [
{
"ChangeNo": "G118110946522",
"UserId": 113,
"ParentOrderID": "118102961851",
"ChangeReason": 1,
"IsFree": false,
"ChangePassengers": [
{
"ChangePassengerID": 10,
"ChangeNO": "G118110946522",
"TickNo": null,
"OldTickNo": "880-2092474486",
"NationCode": "CN",
"PassengerID": 1707,
"ChangeInfo": null,
"Name": "裴建波",
"Nation": "中国",
"PassengerType": 0,
"Sexual": 1,
"IdentifyClass": 2,
"IdentifyNumber": "41132319910525631X",
"Mobile": null,
"Birthday": "1991-05-25",
"VIPCode": null
}
],
"ChangeFlights": [
{
"ChangeFlightID": 17,
"SegmentID": 1448,
"FlightNO": "HU7610",
"ChangeNO": "G118110946522",
"FromCityName": "上海",
"ToCityName": "北京",
"FromAirport": "SHA",
"FromAirportName": "上海虹桥机场 ",
"ToAirport": "PEK",
"ToAirportName": "北京机场 ",
"AirCode": "HU",
"AirName": "海南航空",
"Cabin": "M",
"DepTime": "2018/8/23 18:40:00",
"ArrTime": "2018/8/23 20:55:00",
"ChangeInfo": "出发日期:2018-08-23 -> 2018-12-05;抵达日期:2018-08-23 -> 2018-01-09",
"CabinClass": 1
}
],
"OrderState": 0,
"FinishTime": null,
"Contact": "jackie",
"ChangePrice": {
"ChangePriceID": 10,
"ChangeNO": "G118110946522",
"RefundTotal": 0,
"PayAmount": 0,
"ProviderAmount": 0,
"PlatmAmount": 0
},
"Remark": "改签",
"CreateTime": "2018-11-09T11:51:40.667"
},
{
"ChangeNo": "G118112242099",
"UserId": 0,
"ParentOrderID": "118102961851",
"ChangeReason": 1,
"IsFree": true,
"ChangePassengers": [
{
"ChangePassengerID": 15,
"ChangeNO": "G118112242099",
"TickNo": null,
"OldTickNo": "880-2092474486",
"NationCode": "CN",
"PassengerID": 1707,
"ChangeInfo": "姓名:裴建波 -> hello;手机号: -> 15962488851;国籍:中国 -> 中国澳门特区",
"Name": "hello",
"Nation": "中国澳门特区",
"PassengerType": 0,
"Sexual": 1,
"IdentifyClass": 2,
"IdentifyNumber": "Rafm7TRE0trcVMH8lZrfkMArmMxzpuYp",
"Mobile": "15962488851",
"Birthday": "1991-05-25",
"VIPCode": null
}
],
"ChangeFlights": [
{
"ChangeFlightID": 22,
"SegmentID": 1448,
"FlightNO": "HU7610",
"ChangeNO": "G118112242099",
"FromCityName": "上海",
"ToCityName": "北京",
"FromAirport": "PVG",
"FromAirportName": "上海浦东国际机场",
"ToAirport": "LLI",
"ToAirportName": "拉利贝拉机场 ",
"AirCode": "HU",
"AirName": "海南航空",
"Cabin": "C",
"DepTime": "2018-08-17",
"ArrTime": "2018-08-30",
"ChangeInfo": "出发日期:2018-08-23 -> 2018-08-17;抵达日期:2018-08-23 -> 2018-08-30;出发机场:SHA -> PVG;到达机场:PEK -> LLI;舱位等级:M -> C",
"CabinClass": 1
}
],
"OrderState": 6,
"FinishTime": null,
"Contact": null,
"ChangePrice": {
"ChangePriceID": 15,
"ChangeNO": "G118112242099",
"RefundTotal": 0,
"PayAmount": 0,
"ProviderAmount": 0,
"PlatmAmount": 0
},
"Remark": "改签",
"CreateTime": "2018-11-22T16:45:53.463"
}
]
}
- data:数据列表
- ChangeNo: string 改期单号
- UserId: int 用户ID
- ParentOrderID: string 原始订单编号
- ChangeReason: int 改期原因
- IsFree: boolean 是否免费改签
- ChangePassengers: list 改期乘客
- ChangePassengerID: int ID
- ChangeNO: string 改期单号
- TickNo: string 票号
- OldTickNo: string 老票号
- NationCode: string 国家码
- PassengerID: int 乘机人ID
- ChangeInfo: string 改签信息
- Name: string 姓名
- Nation: string 所在国家
- PassengerType: int 乘机人类型
- Sexual: int 性别
- IdentifyClass: int 证件类型
- IdentifyNumber: string 证件号码
- Mobile: string 手机号码
- Birthday: string 生日
- VIPCode: string 航空公司会员号
- ChangeFlights: list 改期航班
- ChangeFlightID: int 航班ID
- SegmentID: int 原航班ID
- FlightNO: string 航班号
- ChangeNO: string 改期单号
- FromCityName: string 出发城市名
- ToCityName: string 抵达城市名
- FromAirport: string 出发机场三字码
- FromAirportName: string 出发机场
- ToAirport: string 抵达机场三字码
- ToAirportName: string 抵达机场
- AirCode: string 航司代码
- AirName: string 航司名称
- Cabin: string 舱位
- DepTime: string 出发时间
- ArrTime: string 抵达时间
- ChangeInfo: string 更改信息
- CabinClass: int 舱位等级
- OrderState: int 改期状态
- FinishTime: datetime 完成时间
- Contact: string 联系方式
- ChangePrice: 改期价格
- ChangePriceID: int ID
- ChangeNO: string 改签订单号
- RefundTotal: int 退款总金额
- PayAmount: int 支付金额
- Remark: string 备注
- CreateTime: datetime 创建时间
- code:int 返回码,0代表成功
- message: string 返回信息
- TotalRowCount: int 总条数
请求地址:[http://api.app.jinri.cn/api/v1/game/getGameResultsList]
测试请求地址:[http://api.app.jinri.org.cn/api/v1/game/getGameResultsList]
请求示例 (JSON):
{
"gameId": 19,
"gameType": 2,
"sex": "男",
"number": "",
"identityNo": "111111111111111111",
"page":2,
"count":10
}
- gameId int 必填 赛事ID
- gameType int 必填 赛事类型
- sex string 必填 男/女
- number string 必填 号码牌
- identityNo string 必填,证件号
- page int 必填,当前页
- count int 必填,每页数量
返回示例:
{
"pageCount": 10,
"currentPage": 2,
"totalCount": 23,
"data": [
{
"number": "6634",
"name": "许海峰",
"sex": "男",
"identityType": "未知证件类型",
"identityNo": "111111111111111111",
"mobile": "15000989323",
"country": "中国",
"mileage": "21",
"competitionResults": "01:58:56",
"netResults": "01:56:21",
"netRanking": "937",
"starting": "00:02:35",
"ending": "01:58:56",
"gameId": 19,
"gameType": 2,
"updateTime": "2019-01-17 13:42:55",
"id": 3401
}
],
"code": 0,
"isSuccess": true,
"message": "获取赛事成绩列表成功"
}
- data:数据列表
- number: string 号码牌
- name: string 姓名
- sex: string 性别
- identityType: string 证件类型
- identityNo: string 证件号
- mobile: string 手机号
- country: string 国籍
- mileage: string 个人里程
- competitionResults: string 个人赛会成绩
- netResults: string 个人净成绩
- netRanking: string 个人净名次
- starting: string 起点
- ending: string 终点
- gameId: string 赛事ID
- gameType: int 赛事类型
- updateTime: DateTime 更新时间
- id: int 编号
- code:int 返回码,0代表成功
- message: string 返回信息
- TotalRowCount: int 总条数
listStatus 列表订单状态枚举
Key | Value | Description |
---|---|---|
All | 0 | 全部订单 |
WaitPay | 1 | 待支付 |
WaitUse | 2 | 待出行 |
Refund | 3 | 退款/售后 |
apiType、couponType 订单接口类型枚举
Key | Value | Description |
---|---|---|
All | 0 | 全部 |
Game | 1 | 赛事 |
Tourism | 2 | 旅游 |
TrainTicket | 3 | 火车票 |
Hotel | 4 | 酒店 |
Flight | 5 | 机票 |
tripType 航程类型枚举 【只有机票使用】
Key | Value | Description |
---|---|---|
None | 0 | 无 |
OW | 1 | 单程 |
RT | 2 | 往返 |
couponStatus 优惠券状态
Key | Value | Description |
---|---|---|
All | 0 | 全部 |
CanUse | 1 | 未使用 |
Used | 2 | 已使用 |
Expired | 3 | 已过期 |
receiveWay 领取途径
Key | Value | Description |
---|---|---|
OffLine | 1 | 线下 |
APP | 2 | APP |
H5 | 3 | H5 |
eventStatusType 活动状态
Key | Value | Description |
---|---|---|
None | 0 | 待审核 |
OnLine | 1 | 上线 |
OffLine | 2 | 下线 |
eventScopeType 活动类型
Key | Value | Description |
---|---|---|
Register | 0 | 注册优惠 |
Order | 1 | 下单优惠 |
amountType 金额类型
Key | Value | Description |
---|---|---|
Quota | 0 | 定额 |
Reduction | 1 | 满减 |
OrderState 改期状态
Key | Value | Description |
---|---|---|
WaitAudit | 0 | 待审核 |
AuditReturn | 1 | 审核退回 |
WaitPay | 2 | 待付款 |
Payed | 3 | 支付成功 |
WaitComplete | 5 | 待完成 |
Completed | 6 | 已完成 |
Failed | 7 | 已失败 |
Canceled | 9 | 已取消 |
Refunding | 10 | 退款中 |
RefundSuccess | 11 | 退款完成 |
ChangeReason 改期原因
Key | Value | Description |
---|---|---|
WillChange | 1 | 自愿改期 |
Other | 5 | 其他 |
CabinClass 舱位等级
Key | Value | Description |
---|---|---|
A | 0 | 所有舱位 |
B | 1 | 经济舱 |
C | 2 | 公务舱 |
F | 3 | 头等舱 |
GameType 赛事类型
Key | Value | Description |
---|---|---|
FiveKilometre | 1 | 5公里健康跑 |
HalfMarathon | 2 | 半程组 |
FullMarathon | 3 | 全马 |