治疗API
公共请求信息
Header参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| X-Authorization | string | true | 请求认证头部，认证规则详见 鉴权认证。标准格式：Bearer ${Access_token} |
| Accept | string | true | 请设置为 application/json |
| Content-Type | string | true | 请设置为 application/json |
HTTP响应状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 参数错误 |
| 401 | 验证不通过，请参考 鉴权认证 生成认证信息 |
业务错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误 | 请根据接口返回的错误描述检查参数，参数需按API文档字段填写说明填写 |
| 401 | SIGN_ERROR | 签名错误 | 权限检验异常，请详细参考文档 |
| 403 | NO_AUTH | 无权限 | 请前往平台申请此接口相关权限 |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请求频率超限，请降低请求接口频率 |
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请用相同参数重新调用 |
治疗实体信息
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| id | string(36) | false | 【记录编号】该记录的唯一标识 |
| petId | string(36) | true | 【动物id】关联的动物 |
| symptoms | string(36) | false | 【症状】描述动物的症状 |
| treatments | string(36) | false | 【治疗】描述治疗该动物使用的药品 |
| temp | double | false | 【体温】记录动物发病时的体温 |
| tempUnit | string(36) | false | 【体温单位】可选值 ℃、℉，默认为℉ |
| status | integer | true | 【状态】0 治疗中 1 治疗完成 2 已死亡 |
添加或更新治疗
接口说明
请求方式：【POST】/api/treatmentRecord/save
请求域名：【主域名】https://iot.seismi.co
Body 参数
入参遵循告警实体字段规范，按需传参即可；请求体中 id 为空时执行新增操作，非空则根据 id 执行数据更新。
应答参数
200 OK
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| code | integer | true | 业务状态码 |
| msg | string(32) | true | 应答信息 |
删除治疗
接口说明
请求方式：【DELETE】/api/treatmentRecord/${id}，id为系统内的治疗编号
请求域名：【主域名】https://iot.seismi.co
应答参数
200 OK
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| code | integer | true | 业务状态码 |
| msg | string(32) | true | 应答信息 |
请求示例
添加治疗
curl 示例
POST
curl -X POST \
https://iot.seismi.co/api/treatmentRecord/save \
-H "X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIi..." \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"petId" : "2d2f9906-a3d2-4996-bbb2-fdb5f9b7e9ac",
"status" : 0,
"symptoms" : "test",
"treatments" : "test",
"temp" : 20,
"tempUnit" : "℉"
}'
应答示例
200 OK
{
"code" : "200",
"msg" : "success",
"data" : {}
}
删除治疗
curl 示例
DELETE
curl -X DELETE \
https://iot.seismi.co/api/treatmentRecord/a6c62ed7-198e-45c3-8578-762710d5b044 \
-H "X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIi..." \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
应答示例
200 OK
{
"code" : "200",
"msg" : "success",
"data" : {}
}