open-api获取用户答卷及结果分析(待上线)
用户答卷查询
获取用户在当前医院或渠道下所有的答卷结果,接口可以使用用户openId,答题时间段两种维度来进行查询
请求URL:
https://m-api.lejian.com/open-api/V2/resource/listAccountSurvey?accesstoken=ACCESS_TOKEN
请求协议:HTTPS
请求方式:POST
需要签名:否
URL参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| accessToken | 是 | string | 当前有效的accessToken |
POST参数示例
分为两个维度来查询答卷结果
使用用户openID查询(需要分页):
{"openId": "qz2itzakGckPu3KQ0NpbQkwtYOmS","pageOffset":1}
使用答题时间段查询(需要分页):
{"startDate":"2017-09-04","endDate":"2017-09-05""pageOffset":1}
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| openId | 否(二选一) | String | 当前注册用户在开放平台的唯一标识符 |
| startDate | 否(二选一与endDate一起使用) | String | 体检日期(格式:yyyy-mm-dd) |
| endDate | 否(二选一与startDate一起使用) | String | 体检日期(格式:yyyy-mm-dd) |
| pageOffset | 是 | Integer | 分页页码 |
关于分页请参考基础流程第四节
返回示例
正确示例:
{"success": "T","msg": "success","data": {"currentPage": 1,"hasNextPage": false,"surveys": [{"accountSnapshotVO": {"title": "健康体检问卷调查表","openId": "qz2itzakGckPu3KQ0NpbQkwtYOmS","name": "大壮","idCard": "110101199003075517","mobile": "13344442112","gender": 0,"height": 167,"weight": 65,"marriageStatus": 0,"age": 28},"accountSurveyAnswerSnapshots": [{"content": "民族","type": 1,"userAnswers": [{"content": "回族","tips": "","advice": "请避免射线类型的检查项目,并提前告知医生"}]}, {"content": "文化程度","type": 1,"userAnswers": [{"content": "大专","tips": "","advice": ""}]}],"evaluateReport": {"evaluateTime": "2017-09-05","advices": ["请避免射线类型的检查项目,并提前告知医生"],"accountRiskItems": [{"riskName": "呼吸系统","coefficient": 0.965}, {"riskName": "内分泌系统","coefficient": 0.958}],"status": 0,"bmi": 23.3}}]}}
错误示例:
{"success":"F","errCode":"203105","msg":"Invaild OpenId"}
返回参数说明:
- success为返回结果(T表示成功,F表示失败)
- errCode为错误代码,只有失败的时候才有
- msg为返回信息
- data为返回数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| currentPage | Integer | 请参考基础流程第四节 |
| hasNextPage | boolean | 请参考基础流程第四节 |
| surveys | Array[] | 答卷列表,列表内每一个元素都是一份答卷 |
| accountSnapshotVO | String | 用户基本信息 |
| title | String | 问卷名称 |
| name | String | 用户姓名 |
| idCard | String | 身份证 |
| mobile | String | 电话 |
| gender | int | 性别(男:0,女:1) |
| height | Integer | 身高 |
| weight | Integer | 体重 |
| marriageStatus | Integer | 婚否(0:未婚,1:已婚) |
| accountSurveyId | Integer | 答卷id |
| accountSurveyAnswerSnapshots | Arrays[] | 用户问卷答案 |
| content | String | 问题内容 |
| type | Integer | 问题类型 (0:文本,1:单选,2:多选) |
| userAnswers | String | 用户选择答案 |
| content | String | 答案内容 |
| tips | String | 注意事项 |
| advice | String | 建议 |
| evaluateReport | String | 评估结果 |
| evaluateTime | String | 评估时间 |
| accountRiskItems | Arrays[] | 具体风险项 |
| riskName | String | 风险名称 |
| coefficient | double | 风险系数 |
| status | Integer | 评估状态 |
| bmi | double | BMI指数 |
备注:
更多返回错误代码请看首页的接口返回码说明
文档更新时间: 2021-05-27 15:05