1、API List

This part includes sub-accounts related API.

Following is the API list：

• Common Return Code

1.1Create Sub-Account

• Function

  Create a sub-account in B (big account) mode.(sub-account functions description)

• Request Address

  {areaDomain}/api/lapp/ram/account/create

• Request Method

  POST

• Request Parameters

LowerCase(MD5(AppKey#Passwords plaintext)):for AppKey use MD5 encryption to # and plaintext, and transfer to lower letters

• HTTP Request Message

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

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

• Return Data

{
    "data": {
        "accountId": "b3ad7ba927524b748e557572024d4ac2"
    },
    "code": "200",
    "msg": "Operation succeeded!"
}

• Return Filed：

• Return Code

  Common Return Code

1.2 Get Single Sub-Account Information

• Function:

  This port is used for access selected sub-account information.(sub-account function discerption)

• Request Address

  {areaDomain}/api/lapp/ram/account/get

• Request Method

  POST

• Request Parameters

If the accessToken parameter is the same type of sub-account’s AccessToken, the accountId and accountName’s parameter can be none. If not, one of them must not be none, if both of them are not none, port return accountID sub-account information.

• HTTP Request Message

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

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

• Return Data

{
    "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": "Operation succeeded!"
}

• Return Filed:

Policy type(Policy grammar structure)：

Statement type：

• Return Code

  Common Return Code

1.3 Access Sub-account Information List

• Function:

  This port is used for get sub-account information in different pages(sub-account function description)

• Request Address

  {areaDomain}/api/lapp/ram/account/list

• Request Method

  POST

• Request Parameters

• HTTP Request Message

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

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

• Return Data

{
    "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": "Operation succeeded!"
}

• Return Filed:

Page type

Account type

Policy type (Policy grammar structure)：

Statement type：

• Return Code

  Common Return Code

1.4 Edit Current Sub-account Password

• Function

  This port is used for edit current sub-account password

• Request Address

  {areaDomain}/api/lapp/ram/account/updatePassword

• Request Method

  POST

• Request Parameters

LowerCase(MD5(AppKey#plaintext)):for AppKey use MD5 encryption to # and plaintext, and transfer to lower letters

• HTTP Request Message

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

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

• Return Data

{
    "code": "200",
    "msg": "Operation succeeded!"
}

• Return Code

  Common Return Code

1.5 Edit Sub-account Permission Strategy

• Function:

  This port is used for edit mode B sub-account permission strategy

• Request Address

  {areaDomain}/api/lapp/ram/policy/set

• Request Method

  POST

• Request Parameters

• HTTP Request Message

POST /api/lapp/ram/policy/set HTTP/1.1
Host: isgpopen.ezvizlife.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

• Return Data

{
    "code": "200",
    "msg": "Operation succeed!"
}

• Return Code

  Common Return Code

1.6 Add Sub-account Permission

• Function:

  This port is used for add sub-account statement in permission strategy

• Request Address

  {areaDomain}/api/lapp/ram/statement/add

• Request Method

  POST

• Request Parameters

• HTTP Request Message

POST /api/lapp/ram/statement/add HTTP/1.1
Host: isgpopen.ezvizlife.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

• Return Data

{
    "code": "200",
    "msg": "Operation succeed!"
}

• Return Code

  Common Return Code

1.7 Delete Sub-Account Permission

• Function

  This port is used for delete one device’s all statement in a sub-account

• Request Address

  {areaDomain}/api/lapp/ram/statement/delete

• Request Method

  POST

• Request Parameters

• HTTP Request Message

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

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

• Return Data

{
    "code": "200",
    "msg": "Operation succeeded!"
}

• Return Code

  Common Return Code

1.8 Access Mode B Sub-Account AccessToken

• Function

  This port is used for access mode B sub-account accessToken

• Request Address

  {areaDomain}/api/lapp/ram/token/get

• Request Method

  POST

• Request Parameters

• HTTP Request Message

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

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

• Return Data

{
    "data": {
        "accessToken": "ra.7jrcjmna8qnqg8d3dgnzs87m4v2dme3l-32enpqgusd-1jvdfe4-uxo15ik0s",
        "expireTime": 1470810222045,
        "areaDomain": "https://iusopen.ezvizlife.com"
    },
    "code": "200",
    "msg": "Operation succeed !"
}

• Return Code

  Common Return Code

1.9 Delete Sub-Account

• Function

  This port is used for delete sub-account

• Request Address

  {areaDomain}/api/lapp/ram/account/delete

• Request Method

  POST

• Request Parameters

• HTTP Request Message

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

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

• Return Data

{
    "code": "200",
    "msg": "Operation succeed !"
}

• Return Code

  Common Return Code