检测报告检索

使用设备 App 登录用户账号和密码调用请求获取授权令牌,然后使用 获取数据查询access_token 获取到的授权令牌请求查询检测报告。

数据权限

当获取授权令牌使用的用户:

  1. 不在会员团队中时,接口返回“会员不是团队成员”;
  2. 在会员团队中时,接口返回该用户所在团队中所有用户检测产生的报告;
  3. 为会员团队的队长时,接口返回该用户领导的团队及其所有下级团队中所有用户检测产生的报告。

请求

请求地址

https://www.ai-tongue.com/backend/devicecheck/m/report/query

请求方法

GET

请求头

Authorization: bearer {access_token}
access_token 替换 获取数据查询access_token 获取到的授权令牌

请求参数

使用 URL search 传参

参数 描述 必填 备注
phone 检测人手机号
start 检测报告开始时间
end 检测报告结束时间
size 查询结果数量 范围为 1-20,默认为 1

注:

  1. 检测人手机号 phone 未指定时,返回获取授权令牌使用的用户数据权限内的检测报告;
  2. 开始时间 start 与结束时间 end 需同时指定时才生效;
  3. 开始时间与结束时间生效时,查询结果数量 size 无效;
  4. 最大支持查询时长为30天;
  5. 时间支持一些常用格式,包括:
    • yyyy-MM-dd HH:mm:ss
    • yyyy/MM/dd HH:mm:ss
    • yyyy.MM.dd HH:mm:ss
    • yyyy年MM月dd日 HH时mm分ss秒
    • yyyy-MM-dd
    • yyyy/MM/dd
    • yyyy.MM.dd
    • yyyy-MM-dd HH:mm
    • yyyy-MM-dd HH:mm:ss.SSS
    • yyyyMMddHHmmss
    • yyyyMMddHHmmssSSS
    • yyyyMMdd

请求示例

Java OkHttp

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://www.ai-tongue.com/backend/devicecheck/m/report/query?phone=12312341234&size=2")
  .method("GET", null)
  .addHeader("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX2CJ9.eyJleHAiOjE2ODA3NzQwOTcsInVzZXJfbmFtZSI6Inh1d2VuYmluZyIsImp0a3I6ImZjMGFjYzhhLWIzZTctNGJjZi04YjQ3LTk2ZmFkYzAzZWM0NiIsImNsaWVudF4pZCI6ImNsb3VkYXBwIiwic2NvcGUiOlsiKiJdfQ.tES1Bw3Ivf4Q7dk7QLpJ28oFKyiLSLwEL8z6k3R7np1")
  .build();
Response response = client.newCall(request).execute();

响应

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": [
    {
      "teamCode": "TM00000206",
      "teamName": "张三的团队",
      "deviceCode": "YZ-SZY-02B-04-0038",
      "deviceName": "张三的团队设备YZ-SZY-02B-04-0038",
      "loginUserCode": "U00005023",
      "loginUserName": "张三",
      "name": "王五",
      "sex": 1,
      "age": 24,
      "height": 178.32,
      "weight": 75.32,
      "time": "2023-07-24 15:07:40",
      "pdf": "https://td-platform-treatplan.oss-cn-hangzhou.aliyuncs.com/test/devicecheck/2023/07/7b747daa-8dfd-45f4-91bf-0a1159351da9.pdf",
      "healthIndex": 68.50,
      "constitutionNames": "湿热血瘀",
      "symptomName": "",
      "colorOfTongueNames": "淡红舌",
      "colorOfMossNames": "淡黄苔",
      "mossNames": "厚苔,腐",
      "bodyfluidNames": "燥",
      "shapeOfTongueNames": "异常舌形",
      "veinNames": "舌下瘀象",
      "diseaseRisks": "精神压力,骨质疏松症,抑郁症,脑瘫,脂肪肝"
    },
    {
      "teamCode": "TM00000205",
      "teamName": "李四的团队",
      "deviceCode": "YZ-SZY-02B-04-0037",
      "deviceName": "李四的团队设备YZ-SZY-02B-04-0037",
      "loginUserCode": "U00005022",
      "loginUserName": "李四",
      "name": "王五",
      "sex": 1,
      "age": 24,
      "height": 170.54,
      "weight": 51.46,
      "time": "2023-06-14 15:03:36",
      "pdf": "https://td-platform-treatplan.oss-cn-hangzhou.aliyuncs.com/test/devicecheck/2023/06/aac2ce42-0029-4481-aa7e-ece224ed3e34.pdf",
      "healthIndex": 70.60,
      "constitutionNames": "阴虚",
      "symptomName": "心阴虚证,肺阴虚证,肝阴虚证,肝阳上亢证",
      "colorOfTongueNames": "淡红舌",
      "colorOfMossNames": "淡黄苔",
      "mossNames": "厚苔,腻",
      "bodyfluidNames": "润",
      "shapeOfTongueNames": "瘀点,老,齿痕",
      "veinNames": "舌下正常",
      "diseaseRisks": "精神压力,脑瘫,甲状腺结节"
    }
  ]
}

结果格式

格式为 JSON ,响应数据位于 data

参数 类型 描述
code number 0 为成功,其他为失败
msg string 响应结果描述
data array 响应数据

响应数据

data 中数组为响应的检测报告

参数 类型 描述
deviceCode string 检测使用的设备编码
deviceName string 检测使用的设备名称
loginUserCode string 检测使用设备登录的用户编码
loginUserName string 检测使用设备登录的用户名称
teamCode string 检测使用设备登录用户所属会员团队编码
teamName string 检测使用设备登录用户所属会员团队名称
name string 检测人名称
sex number 检测人性别(1男,2女)
age number 检测人年龄
height number 检测人身高
weight number 检测人体重
time string 检测时间
pdf string 检测 PDF 报告 URL
healthIndex number 健康指数,其值越大表示健康状态越好
constitutionNames string 体质
symptomName string 证型,进一步判断体质(constitutionNames)的结果,更为准确体现用户的真实体质
colorOfTongueNames string 舌色
colorOfMossNames string 苔色
mossNames string 苔质
bodyfluidNames string 津液
shapeOfTongueNames string 舌形
veinNames string 络脉
diseaseRisks string 风险疾病名称
©2024 合肥云诊信息科技有限公司 all right reserved,powered by Gitbook修订时间: 2024-08

results matching ""

    No results matching ""