Appearance
新增、更新、删除位置状态配置
接口说明
用于设置宠物 wifi 围栏家地址的配置
请求 URL
本接口通用参数里面 method 的值为 jimi.pet.position.config.update
HTTP 请求方式
POST
请求参数
(1) 通用参数
参见:通用参数
(2) 私有参数
| 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| req | String | 是 | 请求参数 json 对象 |
req 请求参数 json 对象示例
js
{
"imei": "12345678901234",
"items": [
{
"configId": 1,
"lat": "22.543099",
"lng": "114.057868",
"deleteFlag": 0
},
{
"configId": 2,
"lat": "22.567832",
"lng": "114.078951",
"deleteFlag": 1
}
]
}req 数据结构说明,req 为 JSON 对象字符串,结构如下:
| 参数 | 类型 | 描述 |
|---|---|---|
| imei | String | 设备 imei |
| items | String | 配置项 |
items 为 JSON 数组对象,结构如下:
| 参数 | 类型 | 描述 |
|---|---|---|
| configId | String | 设备 imei |
| lat | String | 家的纬度 |
| lng | String | 家的经度 |
| deleteFlag | Integer | 删除标识,1:为删除该配置操作 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它:失败。参考错误码说明 |
| message | String | 如果 code 不为 0,会有相应的错误信息提示 |
| result | String | 查询结果 |
| data | String | 返回数据 |
result 参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceImei | String | 设备 IMEI |
| configId | String | 锚点 id,用于标识区分多个围栏,每个围栏 id 都不同,默认为 1:表示只有单个围栏 |
| lat | String | 纬度 |
| lng | String | 经度 |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": null,
"data": null
}错误返回示例:
js
{
"code": 1004,
"message": "非法访问,token异常!"
}