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查询(需要分页):

  1. {
  2. "openId": "qz2itzakGckPu3KQ0NpbQkwtYOmS",
  3. "pageOffset":1
  4. }

使用答题时间段查询(需要分页):

  1. {
  2. "startDate":"2017-09-04",
  3. "endDate":"2017-09-05"
  4. "pageOffset":1
  5. }
参数名 是否必须 类型 说明
openId 否(二选一) String 当前注册用户在开放平台的唯一标识符
startDate 否(二选一与endDate一起使用) String 体检日期(格式:yyyy-mm-dd)
endDate 否(二选一与startDate一起使用) String 体检日期(格式:yyyy-mm-dd)
pageOffset Integer 分页页码

关于分页请参考基础流程第四节

返回示例

正确示例:

  1. {
  2. "success": "T",
  3. "msg": "success",
  4. "data": {
  5. "currentPage": 1,
  6. "hasNextPage": false,
  7. "surveys": [{
  8. "accountSnapshotVO": {
  9. "title": "健康体检问卷调查表",
  10. "openId": "qz2itzakGckPu3KQ0NpbQkwtYOmS",
  11. "name": "大壮",
  12. "idCard": "110101199003075517",
  13. "mobile": "13344442112",
  14. "gender": 0,
  15. "height": 167,
  16. "weight": 65,
  17. "marriageStatus": 0,
  18. "age": 28
  19. },
  20. "accountSurveyAnswerSnapshots": [{
  21. "content": "民族",
  22. "type": 1,
  23. "userAnswers": [{
  24. "content": "回族",
  25. "tips": "",
  26. "advice": "请避免射线类型的检查项目,并提前告知医生"
  27. }]
  28. }, {
  29. "content": "文化程度",
  30. "type": 1,
  31. "userAnswers": [{
  32. "content": "大专",
  33. "tips": "",
  34. "advice": ""
  35. }]
  36. }],
  37. "evaluateReport": {
  38. "evaluateTime": "2017-09-05",
  39. "advices": ["请避免射线类型的检查项目,并提前告知医生"],
  40. "accountRiskItems": [{
  41. "riskName": "呼吸系统",
  42. "coefficient": 0.965
  43. }, {
  44. "riskName": "内分泌系统",
  45. "coefficient": 0.958
  46. }],
  47. "status": 0,
  48. "bmi": 23.3
  49. }
  50. }]
  51. }
  52. }

错误示例:

  1. {
  2. "success":"F",
  3. "errCode":"203105",
  4. "msg":"Invaild OpenId"
  5. }
返回参数说明:
  1. success为返回结果(T表示成功,F表示失败)
  2. errCode为错误代码,只有失败的时候才有
  3. msg为返回信息
  4. 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