Web端账户接口

anxin

服务器地址

http://121.40.214.215:8000

token格式

• 请求中添加如下格式头域：

Authorization:  token d79be1d657d9a8b45f6f903620e84b06cbf225e0

• 带有[token]标识的接口，需要传入token，例如：

登出接口(token)

ErrorCode说明

• 所有接口里，成功的code为0，其他code请参考接口说明。
  token认证失败相关的ErrorCode：

参数说明

• GET/DELETE参数：请封装在请求的URL中
• POST/PUT参数：请封装在请求的body里

登录接口

接口地址

POST /api/v1/account/login/

• 登录成功后，返回访问token和刷新token；当访问token过期后，需要使用刷新token重新获取新的访问token；如果刷新token也过期，跳转登录页面重新登录。

请求参数

POST /api/v1/account/login/
{
    "login_name": "user",
    "password": "123456789",
}

请求参数说明

返回参数

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "access_token": "6b76d13f9c53496211a93c5b00e0ea379d8527db",
        "refresh_token": "70edcace5683c9e719939da7be5c636571dbcf84",
        "role": 0
    }
}

返回参数说明

用户信息接口(token)

接口地址

GET /api/v1/account/user/

• 登录成功后，返回访问token和刷新token；当访问token过期后，需要使用刷新token重新获取新的访问token；如果刷新token也过期，跳转登录页面重新登录。

请求参数

GET /api/v1/account/login/

返回参数

{
    "meta":{
        "code":0,
        "message":"ok"
    },
    "data":{
        "username":"zrg",
        "cellphone":"",
        "email":"zrg1231@126.com",
        "is_active":true,
        "is_admin":false,
        "is_superuser":true,
        "created_at":"2018-11-07T16:35:22"
    }
}

返回参数说明

token刷新

接口地址

PUT /api/v1/account/new_token/

• 使用刷新token，获取新的访问token和刷新token

请求参数

PUT /api/v1/account/new_token/
{
    "refresh_token": "cc9slxfgbd..."
}

请求参数说明

返回参数

{
    "meta": {
        "code": 0,
        "message": "refresh ok"
    },
    "data": {
        "access_token": "6b76d13f9c53496211a93c5b00e0ea379d8527db",
        "refresh_token": "70edcace5683c9e719939da7be5c636571dbcf84"
    }
}

返回参数说明

登出接口(token)

接口地址

DELETE /api/v1/account/logout/

请求参数

DELETE /api/v1/account/logout/

请求参数说明
无

返回参数

{
    "meta": {
        "code": 0,
        "message": "注销成功！"
    },
    "data": {}
}

修改密码接口（token）

接口地址

PUT /api/v1/account/password/

请求参数

> PUT /api/v1/account/password/
{
    "old_password":"123456789",
    "new_password":"123456789a"
}

请求参数说明

返回参数

{
    "meta": {
        "code": 0,
        "message": "更改密码成功！"
    },
    "data": {}
}

获取验证码接口

POST /app/v1/account/captcha/

请求参数

返回参数

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

忘记密码接口

接口地址

PUT /api/v1/account/password/forgot/

请求参数

> PUT /api/v1/account/password/forgot/
{
    "captcha":"1234",
    "password":"123456789a",
    "login_name":"135********"
}

请求参数说明

返回参数

{
    "meta": {
        "code": 0,
        "message": "Reset password!"
    },
    "data": {}
}

mqtt信息接口(token)

接口地址

GET /api/v1/account/mqtt/

请求参数

> GET /api/v1/account/mqtt/
{
}

请求参数说明
无

返回参数

{
    "meta": {
        "code": 0,
        "message": "ok"
    },
    "data": {
        "device_id": "5c0a1dbcn2spodfl",
        "product_key": "a1CeC7gpByT",
        "mqtt_host": "a1CeC7gpByT.iot-as-mqtt.cn-s...",
        "mqtt_port": 443,
        "mqtt_client_id": "5c0a1dbcn2spodfl|secu...",
        "mqtt_username": "5c0a1dbcn2spodfl&a1CeC7gpByT",
        "mqtt_password": "A35217550550CCED...",
        "command_up_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/command/up",
        "command_down_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/command/down",
        "status_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/status",
        "data_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/data",
        "fault_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/fault",
        "alarm_topic": "/a1CeC7gpByT/5c0a1dbcn2spodfl/user/alarm"
    }
}

成员列表(token)

接口地址

GET /api/v1/members/

• 获取成员列表，默认获取所有用户；也可指定成员角色，比如物业，安装工等

请求示例

/api/v1/members/names/?page=1&page_size=10&role=2
{
}

请求参数说明

返回值

{
    "meta": {
        "message": "info list",
        "code": 0
    },
    "data": {
        "count": 1,
        "page_size": 10,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 23,
                "username": "test2",
                "iot_dname": "5c...",
                "iot_secret": "gaa...",
                "cellphone": "",
                "email": "",
                "updated_at": "2019-05-20T15:33:22",
                "created_at": "2019-05-20T15:33:22",
                "role": 2,
                "owner_id": 21
            }
        ]
    }
}

返回参数说明