接口说明
# 坐姿识别接口文档
## 约定
* `/pose`接口：返回坐标和画好的图（base64编码），每次请求需要提供原图
* `/history`接口：不返回图片，不作为图片服务器使用
## `/pose`
坐姿识别，Request Body需以二进制形式传递图片（参考Postman软件Body栏中的binary选项）。
### 返回示例
```json
{
"detect_result": "success" / "fail",
"result": 类别整数（0/1/2分别表示good/middle/bad） // 如果成功
"fail_feedback": "失败原因描述" // 如果失败,
"humans":[ //图中所有人的人体关键点信息
{
"score": 人体骨架得分, //浮点数
"parts": //一个人的完整关键点应为18个，如果某个关键点不返回即表示没有识别到
[
{
"name":人体关键点名字, //如Nose
"point":[x,y], //关键点位置相对位置坐标
"score":人体关键点得分
},
{
...
}
]
},
{...}
]
}
```
## `/history`
查询接口调用历史，不填参数默认返回不带base64图片的最近20次调用记录。
### 参数列表
| 参数名 | 类型 | 必填 |
| ------------ | ------- | ---- |
| row_num | integer | 否 |
| need_picture | boolean | 否 |
### 返回示例
```json
{
"row_num": 20,
"history": [
{
"request_time": "2020-06-30 12:31:52",
"detect_result": "success",
"detect_type": 3,
"raw_picture": "图片的base64字符串"
},
]
}
```
## `/status`
检测接口运行状态，无需参数。
### 返回示例
```json
{
"status": -1 不正常 / 1 正常,
"describe": "若接口不正常，在此处描述异常信息"
}
```