(金稻/杜亚/森太)接口文档

接口文档

用户注册

获取用户注册验证码

POST /enduser/getVerCode/

请求参数

返回值

{
    "meta": {
        "message": "Send message to phone successfully.",
        "code": 0
    },
    "data": {}
}

错误码

验证码检查

POST /enduser/checkVerCode/

请求参数

返回值

{
    "meta": {
        "message": "signup ok",
        "code": 0
    },
    "data": {
        "token": "eyJhbGciOiJIUzI1N...",
        "clientid": "b6d21b047bed11e78d170016..."
    }
}

字段说明

错误码

用户登录

POST /enduser/login/

请求参数

返回值

{
    "meta": {
        "message": "ok",
        "code": 0
    },
    "data": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbmR1c2VyaWQiOiI3ZGQ2NDJiYTc5MDYxMWU3YmIzZDAwMTYzZTA4NTU1MyIsIm9yaWdfaWF0IjoxNTAyNzA0NTMzLCJpZGVudGlmaWNhdGlvbiI6IjEzNTEwMjYwNTkxIiwiZXhwIjoxNTAzMzA5MzMzLCJhcHBpZCI6IjM1YjA3MDdlLTc4ZGQtMTFlNy1iYjNkLTAwMTYzZTA4NTU1MyJ9.5ozcuYuX03SHNSB41OmezZl_DQr9ymT_o6sEnwDXYpU",
        "clientid": "7dd642ba790611e7bb3d00163e085553"
    }
}

字段说明

刷新应用端授权

POST /enduser/refreshToken/

Headers

返回值

{
    "meta": {
        "message": "ok",
        "code": 0
    },
    "data": {
        "token": "eyJhbGciOiJIUzI1N...",
        "clientid": "b6d21b047bed11e78d170016..."
    }
}

字段说明

错误码

验证应用端授权

POST /enduser/verifyToken/

Headers

返回值

{
    "meta": {
        "message": "ok",
        "code": 0
    },
    "data": {
        "token": "eyJhbGciOiJIUzI1N...",
        "clientid": "b6d21b047bed11e78d170016..."
    }
}

字段说明

错误码

密码重置（jwt认证）

POST /enduser/resetPassword/

Headers

返回值

{
    "meta": {
        "message": "Update password successfully.",
        "code": 0
    },
    "data": {}
}

错误码

用户信息

图片上传接口

POST /upload/img/

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "upload success"
    }, 
    "data": "jd.fogcloud.io/storage/img/20170727164915.png"
}

字段说明

更改头像接口

PUT /user/update_avatar/[enduserid]

请求参数

返回值

{
    "meta":{
        "message":"update success",
        "code":0
    },
    "data":{
        "avatar":"123.png"
    }
}

字段说明

后台管理

用户登录获取Token

POST /get_token/

请求参数

返回值

{
    "meta": {
        "code": 0,
        "messsage": "success"
    },
    "data": {
        "token": "23cfbd8480c7c6737f05204a6ddb617c05faf8dd"
    }
}

字段说明

产品信息

分页获取产品列表

GET /product/?page=[PAGE]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "count": 2,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 1,
                "product_id": "123456",
                "product_name": "cao",
                "product_type": "1"
            },
            {
                "id": 2,
                "product_id": "qwert",
                "product_name": "wefgf",
                "product_type": "asdf"
            }
        ]
    }
}

字段说明

备注

数据列表一页显示10条

添加产品

POST /product/

请求参数

返回值

{
    "meta":{
        "code" : 0,
        "message" : "insert success"
    },
    "data":{
        "id": 1,
        "product_id": "123456",
        "product_name": "cao",
        "product_type": "1"
    }
}

字段说明

根据产品主键（id）获取产品详情

GET /product/detail/[ID]

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "id": 1,
        "product_id": "123456",
        "product_name": "cao",
        "product_type": "1"
    }
}

字段说明

编辑产品信息

PUT /product/detail/[ID]

请求参数

返回值

{
    "meta": {
        "code" : 0,
        "message" : "update success"
    },
    "data": {
        "id": 4，
        "product_id": "2345678",
        "product_name": "2345678",
        "product_type": "sdfghj"
    }
}

字段说明

删除产品

DELETE /product/detail/[ID]

返回值

{
    "meta": {
        "code" : 0,
        "message" : "delete success"
    },
    "data": {}
}

字段说明

产品信息(APP)

分页获取产品列表

GET /product/api/?page=[PAGE]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "count": 2,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 1,
                "product_id": "123456",
                "product_name": "cao",
                "product_type": "1"
            },
            {
                "id": 2,
                "product_id": "qwert",
                "product_name": "wefgf",
                "product_type": "asdf"
            }
        ]
    }
}

参数说明

备注

数据列表一页显示10条

根据产品主键（id）获取产品详情

GET /product/api/detail/[ID]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "id": 1,
        "product_id": "123456",
        "product_name": "cao",
        "product_type": "1"
    }
}

参数说明

产品模板

分页查询产品模板列表

GET /product/template/?page=[PAGE]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "count": 1,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 1,
                "template_name": "dfd",
                "template_json": "{\"name\":\"gaoyang\"}",
                "template_read": 23,
                "product": 1
            }
        ]
    }
}

字段说明

备注

数据列表一页显示10条

添加产品模板

POST /product/template/

请求参数

返回值

{
    "meta": {
        "code" : 0,
        "message" : "insert success"
    },
    "data": {
        "id": 1,
        "template_name": "dfd",
        "template_json": "{\"name\":\"gaoyang\"}",
        "template_read": 23,
        "product": 1
    }
}

字段说明

根据模板主键（id）查询模板详情

GET /product/template/detail/[ID]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "id": 1,
        "template_name": "dfd",
        "template_json": "{\"name\":\"gaoyang\"}",
        "template_read": 23,
        "product": 1
    }
}

字段说明

编辑产品模板

PUT /product/template/detail/[ID]

请求参数

返回值

{
    "meta": {
        "code" : 0,
        "message" : "update success"
    },
    "data": {
        "id": 1234,
        "template_name": "sdfghjk",
        "template_json": "{\"name\":\"gaoyang\"}",
        "template_read": 0,
        "product": 1
    }
}

字段说明

删除产品模板

DELETE /product/template/detail/[ID]

请求参数

返回值

{
    "meta": {
        "code" : 0,
        "message" : "delete success"
    },
    "data": {}
}

字段说明

根据产品主键（id）查询产品模板列表

GET /product/template/[ID]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "count": 1,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 1,
                "template_name": "dfd",
                "template_json": "123",
                "template_read": 23,
                "product": 1
            }
        ]
    }
}

字段说明

备注

数据列表一页显示10条

产品模板(APP)

根据模板主键（id）查询模板详情

GET /product/api/template/detail/[product_id]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "id": 1,
        "template_name": "dfd",
        "template_json": "{\"name\":\"gaoyang\"}",
        "template_read": 23,
        "product": 1
    }
}

参数说明

根据产品主键（id）查询产品模板列表

GET /product/api/template/[ID]

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "find success"
    },
    "data": {
        "count": 1,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 1,
                "template_name": "dfd",
                "template_json": "123",
                "template_read": 23,
                "product": 1
            }
        ]
    }
}

参数说明

备注

数据列表一页显示10条

设备

绑定设备同步厂商服务器

POST /device/api/

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "insert success"
    },
    "data": {
        "id": 1,
        "end_user": "sdfghjk",
        "product_id": "23456789ihg",
        "device_id": "tyuiopsdfghj"
    }
}

字段说明

解绑设备同步厂商服务器

DELETE /device/api/{device_id}

Headers

请求参数

返回值

{
    "meta": {
        "code": 0,
        "message": "delete success"
    },
    "data": {}
}

字段说明

森太反馈接口

用户获取所有反馈

GET /feedback/message/

Headers

返回值

{
    "meta": {
        "message": "查询成功。",
        "code": 0
    },
    "data": [
        {
            "id": 3,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "334444",
            "datetime": "2017-08-10T17:47:01.525958",
            "content": "88444",
            "problem": "44",
            "device": "xxxxxxxxxxxx",
            "respond": false
        },
        {
            "id": 2,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "111111111111",
            "datetime": "2017-08-10T17:37:56.707873",
            "content": "8888888",
            "problem": "888",
            "device": "8888888888888888888",
            "respond": false
        },
        {
            "id": 1,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "13510260591",
            "datetime": "2017-08-10T17:29:31.527515",
            "content": "xfweaegadf",
            "problem": "sfaefawe",
            "device": "dsfadsgaeaegeaefe",
            "respond": true
        }
    ]
}

字段说明

用户反馈问题

POST /feedback/message/

Headers

请求参数

返回值

{
    "meta": {
        "message": "添加成功。",
        "code": 0
    },
    "data": {
        "id": 5,
        "user": "7dd642ba790611e7bb3d00163e085553",
        "phone": "6666",
        "datetime": "2017-08-15T09:54:16.291976",
        "content": "test,test.",
        "problem": "11",
        "device": "xxxxxxxxxxxx",
        "respond": false
    }
}

字段说明

用户删除反馈问题

DELETE /feedback/message/

Headers

请求参数

返回值

{
    "meta": {
        "message": "删除成功。",
        "code": 0
    },
    "data": {}
}

字段说明

后台查询所有反馈问题

GET /feedback/messages/

返回值

{
    "meta": {
        "message": "查询成功。",
        "code": 0
    },
    "data": [
        {
            "id": 3,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "334444",
            "datetime": "2017-08-10T17:47:01.525958",
            "content": "88444",
            "problem": "44",
            "device": "xxxxxxxxxxxx",
            "respond": false
        },
        {
            "id": 2,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "111111111111",
            "datetime": "2017-08-10T17:37:56.707873",
            "content": "8888888",
            "problem": "888",
            "device": "8888888888888888888",
            "respond": false
        },
        {
            "id": 1,
            "user": "7dd642ba790611e7bb3d00163e085553",
            "phone": "13510260591",
            "datetime": "2017-08-10T17:29:31.527515",
            "content": "xfweaegadf",
            "problem": "sfaefawe",
            "device": "dsfadsgaeaegeaefe",
            "respond": true
        }
    ]
}

字段说明

后台删除反馈问题

DELETE /feedback/messages/

请求参数

返回值

{
    "meta": {
        "message": "删除成功。",
        "code": 0
    },
    "data": {}
}

字段说明

查询反馈回复

GET /feedback/messageResponse/

请求参数

返回值

{
    "meta": {
        "message": "查询成功。",
        "code": 0
    },
    "data": [
        {
            "id": 5,
            "record": 1,
            "datetime": "2017-08-14T17:35:48.860838",
            "content": "多次尝试"
        }
    ]
}

字段说明

后台回复反馈

POST /feedback/messageResponse/

请求参数

返回值

{
    "meta": {
        "message": "添加成功。",
        "code": 0
    },
    "data": {
        "id": 6,
        "record": 2,
        "datetime": "2017-08-15T10:09:15.729327",
        "content": "回复演示"
    }
}

字段说明

后台删除反馈回复

DELETE /feedback/messageResponse/

请求参数

返回值

{
    "meta": {
        "message": "删除成功。",
        "code": 0
    },
    "data": {}
}

字段说明

查询问题类型

GET /feedback/problemTypes/

返回值

{
    "meta": {
        "message": "获取问题类型。",
        "code": 0
    },
    "data": [
        "设备使用问题",
        "APP使用出错",
        "设备配网问题",
        "功能与设计建议",
        "其他"
    ]
}

字段说明

查询FAQ

GET /feedback/FAQ/

返回值

{
    "meta": {
        "message": "获取常见问题。",
        "code": 0
    },
    "data": [
        {
            "content": "确认是否联网，有没有断开设备。",
            "title": "设备为什么连接不成功？"
        },
        {
            "content": "可以换取礼品，只能在积分商城板块类目下可以使用。",
            "title": "怎么添加设备？"
        },
        {
            "content": "也可以接受手机热点的连接。",
            "title": "设备只能连接无线吗？"
        }
    ]
}

字段说明

获取设备数据记录

• 日数据

GET api/device_bsy_today/{enduserid}

• 周数据

GET api/device_bsy_week/{enduserid}

• 月数据

GET api/device_bsy_month/{enduserid}