App端接口

anxin

设备详情接口(token)

接口地址

GET /api/v1/enduser/devices/{device_id}/

• 获取设备详情信息

请求参数示例

> GET /api/v1/enduser/devices/00182001/
{
}

请求参数说明

返回参数示例

# 三相空开：
{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "area_code": [
            "1",
            "2",
            "3"
        ]
    }
}
# 水电表：
{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "cur_price": "3.00",
        "app_can_open_wm": true,
        "app_can_open_em": true
    }
}

返回参数说明

获取子设备信息(token)

接口地址

GET /api/v1/enduser/device/lines/

• 通过get接口获取不到子设备别名，或返回的子设备数跟设备上报的子设备数不一致时，需要调用post接口重新上传子设备数，服务端会为新的子设备创建默认的名称。
• 如果设置line_id则表示获取指定分路的信息

请求参数示例

# 获取所有分路信息
> GET /api/v1/enduser/device/lines/?device_id=aaxss...
{
}
# 获取指定分路信息
> GET /api/v1/enduser/device/lines/?device_id=aaxss...&line_id=2
{
}

请求参数说明

返回参数示例

# 所有分路信息
{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": [
        {
            "line": 2,
            "device_id": "3835c11ad2d511e99fe100163e00e478",
            "line_alias": "断路开关合约机hyj",
            "area": [],
            "area_code": [],
            "address": ""
        },
        {
            "line": 1,
            "device_id": "3835c11ad2d511e99fe100163e00e478",
            "line_alias": "塑壳1",
            "area": [
                "sh",
                "sh"
            ],
            "area_code": [
                "1",
                "2"
            ],
            "address": "zzz"
        }
    ]
}
# 指定分路信息
{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "line": 2,
        "device_id": "3835c11ad2d511e99fe100163e00e478",
        "line_alias": "塑壳2",
        "area": [
            "天津市",
            "天津市"
        ],
        "area_code": [
            "140000",
            "140300"
        ],
        "address": "789888"
    }
}

返回参数说明

创建子设备(token)

接口地址

POST /api/v1/enduser/device/lines/

• 创建子设备：通过get接口获取不到子设备别名，或子设备数不一致时，需要重新上传子设备数，服务端会为新的子设备创建默认的名称。

请求参数示例

> POST /api/v1/enduser/device/lines/
{
    "device_id": "jdkksdx...",
    "total_line": 10,
    "leak_line": [1, 2, 3]
}

请求参数说明

返回参数示例

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": [
        {
            "device_id": "3835c11ad2d511e99fe100163e00e478",
            "line": 1,
            "line_alias": "塑壳开关",
            "area": [],
            "area_code": [],
            "address": ""
        },
        {
            "device_id": "3835c11ad2d511e99fe100163e00e478",
            "line": 2,
            "line_alias": "塑壳开关",
            "area": [],
            "area_code": [],
            "address": ""
        }
    ]
}

返回参数说明

修改子设备信息(token)

接口地址

PUT /api/v1/enduser/device/lines/

• 根据子设备id，修改指定子设备的别名

请求参数示例

> PUT /api/v1/enduser/device/lines/
{
    "device_id": "3835c11ad2d511e99fe100163e00e478",
    "line": 1,
    "line_alias": "塑壳1",
    "area": ["sh", "sh"],
    "area_code": ["1", "2"],
    "address": "zzzz"
}

请求参数说明

返回参数示例

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {}
}

返回参数说明

更新设备信息(token)

接口地址

PUT /api/v1/enduser/devices/

• 根据设备id，更新指定设备的信息

请求参数示例

> PUT /api/v1/enduser/devices/
{
    "device_id":"759880dce...",
    "area":["上海市", "上海市"],
    "area_code": ["1","2","3"    ],
    "address":"一楼旁",
    "device_alias":"zzz"
}

请求参数说明

返回参数示例

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "device_id": "995"
    }
}

返回参数说明

移除指定用户(token)

接口地址

POST /api/v1/enduser/remove/

• 管理员移除指定用户

请求参数示例

> POST /api/v1/enduser/remove/
{
    "device_id":"759880d...",
    "enduser_id":"fc8c110a..."
}

请求参数说明

返回参数示例

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {}
}

返回参数说明