接口列表

本节包含子账户相关接口等。

接口列表如下：

• 公共返回码:

创建子账户

• 接口功能

  创建B(大账户)模式的子账户。（子账户功能说明）

• 请求地址

  https://open.ys7.com/api/lapp/ram/account/create

• 请求方式

  POST

• 请求参数

LowerCase(MD5(AppKey#密码明文))：对AppKey、#和明文密码拼接起来的字符串进行MD5加密，并转成小写

• HTTP请求报文

POST /api/lapp/ram/account/create HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&accountName=test&password=5305b671da2d66785f7e6dd24c117370

• 返回数据

{
    "data": {
        "accountId": "b3ad7ba927524b748e557572024d4ac2"
    },
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段

• 返回码

参见 公共返回码

获取单个子账户信息

• 接口功能：

  该接口用于获取指定子账户信息。（子账户功能说明）

• 请求地址

  https://open.ys7.com/api/lapp/ram/account/get

• 请求方式

  POST

• 请求参数

如果accessToken参数是子账户类型的AccessToken，accountId和accountName参数可为空；否则accountId和accountName其中一个必须不为空；如果两个都不为空，接口返回accountId的子账户信息

• HTTP请求报文

POST /api/lapp/ram/account/get HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "data": {
        "accountId": "b3ad7ba927524b748e557572024d4ac2",
        "accountName": "test",
        "appKey": "ae1b9af9dcac4caeb88da6dbbf2dd8d5",
        "accountStatus": 1,
        "policy": {
            "Statement": [
                {
                    "Permission": "GET,UPDATE,REAL",
                    "Resource": [
                        "dev:469631729",
                        "dev:519928976",
                        "cam:544229080:1"
                    ]
                },
                {
                    "Permission": "GET",
                    "Resource": [
                        "dev:470686804"
                    ]
                }
            ]
        }
    },
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段：

Policy类型（Policy语法结构）：

Statement类型：

• 返回码

参见 公共返回码

获取子账户信息列表

• 接口功能：

  该接口用于分页获取应用下的子账户信息列表。（子账户功能说明）

• 请求地址

  https://open.ys7.com/api/lapp/ram/account/list

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/account/get HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&pageStart=0&pageSize=2

• 返回数据

{
    "page": {
        "total": 15,
        "page": 0,
        "size": 2
    },
    "data": [
        {
            "accountId": "b3ad7ba927524b748e557572024d4ac2",
            "accountName": "test",
            "appKey": "ae1b9af9dcac4caeb88da6dbbf2dd8d5",
            "accountStatus": 1,
            "policy": {
                "Statement": [
                    {
                        "Permission": "GET,UPDATE,REAL",
                        "Resource": [
                            "dev:469631729",
                            "dev:519928976",
                            "cam:544229080:1"
                        ]
                    },
                    {
                        "Permission": "GET",
                        "Resource": [
                            "dev:470686804"
                        ]
                    }
                ]
            }
        },
        {
            "accountId": "0058a3964698415d8a70a931faa48d78",
            "accountName": "test2",
            "appKey": "ae1b9af9dcac4caeb88da6dbbf2dd8d5",
            "accountStatus": 1,
            "policy": null
        }
    ],
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段：

Page类型

Account类型

Policy类型（Policy语法结构）：

Statement类型：

• 返回码

参见 公共返回码

修改当前子账户密码

• 接口功能

  该接口用于修改当前子账户的密码。

• 请求地址

  https://open.ys7.com/api/lapp/ram/account/updatePassword

• 请求方式

  POST

• 请求参数

LowerCase(MD5(AppKey#密码明文))：对AppKey、#和明文密码拼接起来的字符串进行MD5加密，并转成小写

• HTTP请求报文

POST /api/lapp/ram/account/updatePassword HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&accountId=b3ad7ba927524b748e557572024d4ac2&oldPassword=5305b671da2d66785f7e6dd24c117370&newPassword=cc03e747a6afbbcbf8be7668acfebee5

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码

设置子账户的授权策略

• 接口功能：

  该接口用于设置B模式子账户授权策略

• 请求地址

  https://open.ys7.com/api/lapp/ram/policy/set

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/policy/set HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&policy=%7B%22Statement%22%3A%5B%7B%22Permission%22%3A+%22GET%2CUPDATE%2CREAL%22%2C%22Resource%22%3A%5B%22dev%3A469631729%22%2C%22dev%3A519928976%22%2C%22cam%3A544229080%3A1%22%5D%7D%5D%7D&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码

增加子账户权限

• 接口功能：

  该接口用于增加子账户授权策略中的授权语句

• 请求地址

  https://open.ys7.com/api/lapp/ram/statement/add

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/statement/add HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&statement==%7B%22Permission%22%3A+%22GET%22%2C+%22Resource%22%3A+%5B%22dev%3A547596317%22%5D%7D&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码

删除子账户权限

• 接口功能：

  该接口用于删除子账户授权策略中某个设备的所有授权语句

• 请求地址

  https://open.ys7.com/api/lapp/ram/statement/delete

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/statement/delete HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&deviceSerial==547596317&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码

获取B模式子账户accessToken

• 接口功能：

  该接口用于获取B模式子账户accessToken

• 请求地址

  https://open.ys7.com/api/lapp/ram/token/get

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/token/get HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "data": {
        "accessToken": "ra.7jrcjmna8qnqg8d3dgnzs87m4v2dme3l-32enpqgusd-1jvdfe4-uxo15ik0s",
        "expireTime": 1470810222045
    },
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码

删除子账户

• 接口功能：

  该接口用于删除子账户

• 请求地址

  https://open.ys7.com/api/lapp/ram/account/delete

• 请求方式

  POST

• 请求参数

• HTTP请求报文

POST /api/lapp/ram/account/delete HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9307p5ye4yilog2f9apn82368j9g62g1-2rs1w3h0k0-092yx3m-ysd3i9cg9&accountId=b3ad7ba927524b748e557572024d4ac2

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

参见 公共返回码