有道云地址:https://note.youdao.com/s/UTC3phw
接口请求步骤说明:
1.先根据提供给自助机的appKey及AppSecret请求获取AccessToken接口,获取accesstoken调用凭据。
2.套餐接口和号源接口仅需要AccessToken即可,根据accessToken及Json格式-requestBody请求具体接口,返回需要的数据。
3.下单接口加密,需要获取nonce及通过相应规则Md5加密生成sign,将accessToken、nonce、sign作为url参数,context作为post内容,调用下单接口。
=============================================================================
Open-api提供给惠州三院-自助机的相关AppKey等信息:
APP名称:惠州三院-自助机(体检中心)
APP Key
ap05f7db1df39c4c219db146407edf1e22
APP Secret
748689b92f6f4bd084f78609905a5f4e
数据签名(signKey)
3801a8059dc54efb9b89852337d2efed
加密密码
Z0MGQnOg2KIhGIjozQH8X4AWziO2zwKA1wGKlGWqsLr
===========================================================================
每天健康开放平台《开发说明》:http://doc.mytijian.cn/docs/hospitalAccess/hospitalAccess-1an6fslrmidl5
获取AccessToken:http://doc.mytijian.cn/docs/hospitalAccess/hospitalAccess-1an6hfjit997a
接口数据签名(nonce及MD5加密Demo):http://doc.mytijian.cn/docs/hospitalAccess/hospitalAccess-1an6hjv9hk3o5
===========================================================================
提供给自助机的具体接口:
1.套餐接口(支持分页列表、套餐单独查询)
2.号源查询
3.下单接口
1.套餐接口(支持分页列表、套餐单独查询):
请求URL
https://api.mytijian.com/open-api/V2/resource/listMealsOfHospital?accessToken=ACCESS_TOKEN
请求协议:HTTPS
请求方式:POST
需要签名: 否
URL参数:
参数名是否必须类型说明accessToken是string当前有效的accessToken
POST参数示例
①.使用体检中心查询-Josn:
{
“hospitalId”: 514,// 必填,惠州三院体检中心id-514
“pageOffset”: 1,// 必填,分页页码
“genderList”:[0,2]// 体检人性别:0:男,1:女,2:男女通用 , 如果是男的,传参案例[0,2]. 如果是女的,传参案例[1,2]
}
②.使用套餐id查询具体套餐-Json:
{
“hospitalId”:514,// 必填,惠州三院体检中心id-514
“mealIds”:[555235]// 套餐id
}
正确返回示例:
{
“data”: {
“hasNextPage”: false,// 是否还存在下一页
“currentPage”: 1,//当前页数
“meals”: [
{
“classify”: 1,
“mealId”: 555235,//套餐id
“gender”: 2,//套餐性别 0:男,1:女,2:男女通用
“examItems”: [// 套餐中的单项集合
{
“itemId”: 4139867,//单项id
“itemType”: 1,
“price”: 1000,//单项价格
“name”: “血压”//单项名称
}
],
“description”: “asdfdasfasf”,//套餐描述
“initPrice”: 2,
“marriageValue”: “通用”,
“hospitalName”: “QA测试医院”,
“type”: 3,
“ageLevelId”: 0,
“createTime”: “2021-12-28”,
“hospitalId”: 147,
“marriageId”: 0,
“price”: 2,//套餐价格
“ageLevelValue”: “全年龄段(不限年龄)”,
“name”: “支付测试官方套餐”,
“keyword”: “”
}
]
},
“msg”: “success”,
“success”: “T”
}
请求示例:
注意这里示例是测试环境的域名,到时候请求用正式环境即可。
2.号源查询:
请求URL
https://api.mytijian.com/open-api/V2/counter/queryOrderableCapacity?accessToken=ACCESS_TOKEN
请求协议:HTTPS
请求方式:POST
需要签名: 否
URL参数:
参数名是否必须类型说明accessToken是string当前有效的accessToken
POST参数示例
{
“hospitalId”:”514”,//体检中心id,惠州三院用514
“startDate”:”2022-02-29”,//开始日期字符串
“endDate”:”2022-04-24”,//结束日期字符串
“mealId”:460898//套餐id
}
正确返回示例:
{
“data”: {
“dayCapacitys”: [// 天数容量列表,列表类为每天的人数容量
{
“dateStr”: “2022-01-28”,//日期(格式:yyyy-mm-dd)
“periodCapacitys”: [// 时段容量列表,当天时段列表
{
“usable”: true,// 是否可约
“period”: 4003663,// 时段编号,用于下单
“numFull”: false,
“dayRest”: false,
“periodName”: “10:00-11:00”,
“remark”: “0600-0700”,
“availableNum”: 450,// 可约订单数
“maxNum”: 450
},
{
“usable”: true,
“period”: 4003799,
“numFull”: false,
“dayRest”: false,
“periodName”: “11:00-12:00”,
“remark”: “8点到17点”,
“availableNum”: 450,
“maxNum”: 450
}
]
}
]
},
“msg”: “success”,
“success”: “T”
}
请求示例:
注意这里示例是测试环境的域名,到时候请求用正式环境即可。
3.下单:
请求URL
https://api.mytijian.com/open-api/V2/order/book?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
参数名是否必须类型说明accessToken是string当前有效的accessTokennonce是string当前有效的noncesign是string数据sign值
关于nonce和sign请查看 数据签名。
POST参数示例
{
“examDate”:”2022-01-29”,// 必传,体检日期
“examTimeIntervalId”:4003566,// 必传,体检时段,即选择的号源的时段id
“mealId”:”553867”,// 必传,套餐id
“mobile”:”15867106139”,// 必传,体检人手机号
“examAccountName”:”陈沈澳”,// 必传,体检人姓名
“idType”:1,// 必传,证件类型:0.其他 1.身份证 2.护照 3.军官证 4.港澳身份证 5.台胞证
“idCard”:”330327199710033012”,// 必传,证件号码
“orderPrice”:1000,// 必传,订单价格,等价于套餐价格
“orderScene”:20, // 必传,代表自助机下单。
“married”:0,// 婚姻状况:0 通用 1 已婚
“gender”:0,// 性别:0:男,1:女,2:男女通用
“age”:25,// 体检人年龄
}
正确返回示例:
{
“data”: {
“createTime”: “2022-02-09 14:41:00”,
“examDate”: “2022-03-01”,
“hospitalId”: 147,
“orderNum”: “20220209144100644001980”,//订单编号
“orderStatus”: “unpay”,
“orderPrice”: 1000,
“hospitalName”: “QA测试医院”,
“mealName”: “多选一分组套餐12222222”,
“items”: [
{
“price”: 1000,
“name”: “血压”
}
],
“status”: 2 // status状态见下,返回2,预约成功即可。
},
“msg”: “success”,
“success”: “T”
}
status状态:
(0,”待付款”),
、(1,”已付款”),
、(2, “预约成功”),
、(20, “预约失败”),
、(21, “预约中”),
、(3, “体检完成”),
、(4, “改期成功”),
、(40, “改期失败”),、(41, “改期中”),
、(5,”已撤销”),
、(50,”撤销失败”),
、(51,”撤销中”),
、(6,”已删除”),
、(8,”已关闭”),
、(9,”部分退款”)
请求示例:
注意这里示例是测试环境的域名,到时候请求用正式环境即可。