检测报告检索
使用设备 App 登录用户账号和密码调用请求获取授权令牌,然后使用 获取数据查询access_token
获取到的授权令牌请求查询检测报告。
数据权限
当获取授权令牌使用的用户:
- 不在会员团队中时,接口返回“会员不是团队成员”;
- 在会员团队中时,接口返回该用户所在团队中所有用户检测产生的报告;
- 为会员团队的队长时,接口返回该用户领导的团队及其所有下级团队中所有用户检测产生的报告。
请求
请求地址
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 |
注:
- 检测人手机号
phone
未指定时,返回获取授权令牌使用的用户数据权限内的检测报告; - 开始时间
start
与结束时间end
需同时指定时才生效; - 开始时间与结束时间生效时,查询结果数量
size
无效; - 最大支持查询时长为30天;
- 时间支持一些常用格式,包括:
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 |
风险疾病名称 |