检测报告检索

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

数据权限

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

不为会员团队的队长时，接口返回“会员不是团队负责人”；
为会员团队的队长时，接口返回该用户领导的团队及其所有下级团队中所有用户检测产生的报告。

请求

请求地址

https://yz365.tongueai.com/yz365-b2b2c/seller/tongue/check/record/queryopen in new window

请求方法

GET

请求头

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

请求参数

使用 URL search 传参

参数	描述	必填	备注
`phone`	检测人手机号	是
`start`	检测报告开始时间	否
`end`	检测报告结束时间	否
`size`	查询结果数量	否	范围为 `1-10`，默认为 `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://yz365.tongueai.com/yz365-b2b2c/seller/tongue/check/record/query?phone=12312341234&size=2")
  .method("GET", null)
  .addHeader("accessToken", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX2CJ9.eyJleHAiOjE2ODA3NzQwOTcsInVzZXJfbmFtZSI6Inh1d2VuYmluZyIsImp0a3I6ImZjMGFjYzhhLWIzZTctNGJjZi04YjQ3LTk2ZmFkYzAzZWM0NiIsImNsaWVudF4pZCI6ImNsb3VkYXBwIiwic2NvcGUiOlsiKiJdfQ.tES1Bw3Ivf4Q7dk7QLpJ28oFKyiLSLwEL8z6k3R7np1")
  .build();
Response response = client.newCall(request).execute();

响应

响应示例

{
	"success": true,
	"message": "success",
	"code": 200,
	"timestamp": 1727233247994,
	"result": [
		{
			"teamCode": "T-001",
			"teamName": "测试团队",
			"deviceCode": "YZ365-FD-24090077",
			"deviceName": "wx",
			"personName": "君迁子",
			"personSex": 1,
			"personAge": 22,
			"personHeight": 0,
			"personWeight": 0,
			"checkTime": "2024-05-22 14:54:52",
			"pdfUrl": "https://tongueaiyz365.oss-cn-qingdao.aliyuncs.com/ai/report/2024/09/52846063735b4f63a9bebd30436f78a7.pdf",
			"healthIndex": 68.50,
            "constitutionNames": "湿热血瘀",
            "symptomName": "",
            "colorOfTongueNames": "淡红舌",
            "colorOfMossNames": "淡黄苔",
            "mossNames": "厚苔,腐",
            "bodyfluidNames": "燥",
            "shapeOfTongueNames": "异常舌形",
            "veinNames": "舌下瘀象",
            "diseaseRisks": "精神压力,骨质疏松症,抑郁症,脑瘫,脂肪肝"
		},
        {
			"teamCode": "T0000000",
			"teamName": "张三团队",
			"deviceCode": "YZ365-FD-44011077",
			"deviceName": "zs",
			"personName": "张三",
			"personSex": 1,
			"personAge": 22,
			"personHeight": 0,
			"personWeight": 0,
			"checkTime": "2024-05-22 14:54:52",
			"pdfUrl": "https://tongueaiyz365.oss-cn-qingdao.aliyuncs.com/ai/report/2024/09/52846063735b4f63a9bebd30436f78a7.pdf",
            "healthIndex": 70.60,
            "constitutionNames": "阴虚",
            "symptomName": "心阴虚证,肺阴虚证,肝阴虚证,肝阳上亢证",
            "colorOfTongueNames": "淡红舌",
            "colorOfMossNames": "淡黄苔",
            "mossNames": "厚苔,腻",
            "bodyfluidNames": "润",
            "shapeOfTongueNames": "瘀点,老,齿痕",
            "veinNames": "舌下正常",
            "diseaseRisks": "精神压力,脑瘫,甲状腺结节"
		}
	]
}

结果格式

格式为 JSON ，响应数据位于 data 中

参数	类型	描述
`code`	`number`	`200` 为成功，其他为失败
`success`	`boolean`	响应状态，`success`为成功，其他为失败
`message`	`string`	响应结果描述
`timestamp`	`number`	时间戳
`result`	`array`	响应数据

响应数据

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

参数	类型	描述
`teamCode`	`string`	检测使用设备登录用户所属会员团队编码
`teamName`	`string`	检测使用设备登录用户所属会员团队名称
`deviceCode`	`string`	检测使用的设备编码
`deviceName`	`string`	检测使用的设备名称
`personName`	`string`	检测人名称
`personSex`	`number`	检测人性别（`1`男，`2`女）
`personAge`	`number`	检测人年龄
`personHeight`	`number`	检测人升高（单位`cm`）
`personWeight`	`number`	检测人体重（单位`kg`）
`checkTime`	`string`	检测时间
`pdfUrl`	`string`	检测 PDF 报告 URL
`healthIndex`	`number`	健康指数，其值越大表示健康状态越好
`constitutionNames`	`string`	体质
`symptomName`	`string`	证型，进一步判断体质（`constitutionNames`）的结果，更为准确体现用户的真实体质
`colorOfTongueNames`	`string`	舌色
`colorOfMossNames`	`string`	苔色
`mossNames`	`string`	苔质
`bodyfluidNames`	`string`	津液
`shapeOfTongueNames`	`string`	舌形
`veinNames`	`string`	络脉
`diseaseRisks`	`string`	风险疾病名称