舌面象预判接口
接口描述
此接口用于预判舌面象是否合格。
建议预判舌象是合格时，再去调用“确认提交接口”；也就是说即使面象预判不合格，也可以调用“确认提交接口”接口。
- 此接口会立即响应上传成功与否；预判结果通过“结果回调”接口接收。
接口说明
- 请求地址：
http://www.xiyasi-faucet.com/backend/interfacesvc/i/composite/task/pre - 请求头：
Authorization： Bearer {access_token}Authorization是请求头名称；Bearer {access_token}是请求头的值；{access_token}是授权令牌，通过获取企业应用access_token获取。
- 请求方式：
POST
请求参数
- 使用form-data方式传参。
参数名 |
变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 第三方单据流水号 | outId |
String | 是 | 第三方唯一标识 |
| 签名 | signature |
String | 是 | 对outId进行RSA签名后得到的字符串。签名工具请参考“资源下载” |
| 加密数据 | encryptData |
String | 是 | 原文形如：{"imageType":1,"returnUrl":"https://www.tongueai.com/composite/resultReturn"}，然后使用AES算法对其加密得到的字符串。1. 加密数据对象详见下面加密数据对象 2. 加密算法请参考“资源下载”。 |
| 舌面图片 | tongueImg |
File | 否 | imageType=1时必传 |
| 舌下图片 | tongueBackImg |
File | 否 | imageType=1时有效 |
| 正面图片 | faceImg |
File | 否 | imageType=1时必传 |
| 左侧面图片 | faceLeftImg |
File | 否 | imageType=1时有效 |
| 右侧面图片 | faceRightImg |
File | 否 | imageType=1时必传 |
加密数据对象
参数名 |
变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 检测结果接收地址 | returnUrl |
String | 是 | 支持http/https，需要互联网访问 |
| 舌面/舌下图片类型 | imageType |
Number | 否 | 1：文件对象 2：网络图片地址，支持http/https 默认是1 |
| 舌面图片 | tongueImgUrl |
String | 否 | imageType=2时必传 |
| 舌下图片 | tongueBackImgUrl |
String | 否 | imageType=2时有效 |
| 正面图片 | faceImgUrl |
String | 否 | imageType=2时必传 |
| 左侧面图片 | faceLeftImgUrl |
String | 否 | imageType=2时有效 |
| 右侧面图片 | faceRightImgUrl |
String | 否 | imageType=2时有效 |
| 预判严格程度 | strictLevel |
Number | 否 | 取值范围： [0,100]，数值越大表示越严格。默认为系统内置严格程度 |
请求示例
- Postman导出的请求示例如下，您也可以导入Postman后查看
{ "info": { "_postman_id": "e8739229-6997-4838-8ed3-d69333d0a7e9", "name": "Demo20231023", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "pre", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2OTgwNTc0MzAsInVzZXJfbmFtZSI6ImhmbXhfdGVzdF9hcGlfYXBwIiwianRpIjoiOTI2MWU5NjktY2JhOS00MGM1LWFiMTAtNDhjNWU3NDRjZmRhIiwiY2xpZW50X2lkIjoiaGZteF90ZXN0X2FwaV9hcHAiLCJzY29wZSI6WyIqIl19.DAuZh9NtLpBOpBtQgq9RuN6nvodqWNlTn3Oplg_GgS8", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "outId", "value": "2", "type": "default" }, { "key": "signature", "value": "gUQZiVD08gK15Tnv/v/rUm94+2jULPSVUOt7P0E8BROnJKlrsg4cgunN7FMxtDrujK+4b7KaVGFxQpFK7ThhIFf4nM640uilJWxo+CHcS+mwvLiu4Gih8M+7RuLcnMjScDoNw9f3HB9pcEj2ZmbbMlERftfdvQ80ie1BC+hMd/g=", "type": "default" }, { "key": "encryptData", "value": "/5Elf+7JhOA0zfixZ+Y00LR2QBBz4UoIXL2yDtwjvHeNTzRvV6Or+T4xInIoK3/ozx7BtvjYjXu6ClF2brahEP9rXf7kikGodCAE870ACw36XjYWT7lIiickc5qWPE8V", "type": "default" }, { "key": "tongueImg", "type": "file", "src": "/C:/Users/Administrator/Desktop/舌&面/舌面.jpg" }, { "key": "tongueBackImg", "type": "file", "src": "/C:/Users/Administrator/Desktop/舌&面/舌下.jpg" }, { "key": "faceImg", "type": "file", "src": "/C:/Users/Administrator/Desktop/舌&面/正.jpg" }, { "key": "faceLeftImg", "type": "file", "src": "/C:/Users/Administrator/Desktop/舌&面/左.jpg" }, { "key": "faceRightImg", "type": "file", "src": "/C:/Users/Administrator/Desktop/舌&面/右.jpg" } ] }, "url": { "raw": "http://www.xiyasi-faucet.com/backend/interfacesvc/i/composite/task/pre", "protocol": "https", "host": [ "www", "ai-tongue", "com" ], "path": [ "backend", "interfacesvc", "i", "composite", "task", "pre" ] } }, "response": [] } ] }
响应参数
参数名 |
变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 错误码 | code |
Number | 是 | code为0表示成功；code不为0表示错误 |
| 提示信息 | msg |
String | 是 | code为0时，此字段是“成功”；code不为0时，此字段是错误提示信息 |
| 数据 | data |
Object | 否 | {} 或 [] |
响应示例
- 成功的例子
{
"code": 0,
"msg": "成功"
}
- 失败的例子
{
"code": 2609002,
"msg": "第三方单据唯一标识已存在"
}