身份管理

身份管理接口用于创建、修改、删除和查询用户身份。用户可以创建多个身份，每个身份下可以独立管理域名和数据，实现多身份隔离。

身份与数据隔离

不同身份之间的域名、Cookie、LocalStorage 数据互相隔离。在域名管理和数据上传下载接口中，通过 identityId 参数指定操作的身份；不传时使用默认身份。

身份列表

获取当前用户的所有身份。

• URL： /open/userIdentity/list
• 方法： GET

请求参数

无。

请求示例

curl "https://cookieplus.perk-net.com/api/open/userIdentity/list" \
  -H "token: d7b******62f"

响应示例

{
  "code": 200,
  "msg": "执行成功",
  "data": [
    {
      "id": 1,
      "identity": "工作",
      "remark": "工作相关网站",
      "isDefault": true
    },
    {
      "id": 2,
      "identity": "个人",
      "remark": "个人账号",
      "isDefault": false
    }
  ]
}

响应字段

字段	类型	说明
id	integer	身份 ID
identity	string	身份名称
remark	string	备注
isDefault	boolean	是否为默认身份

---

新建身份

创建一个新的用户身份。

• URL： /open/userIdentity/create
• 方法： POST
• Content-Type： application/json

请求参数

参数	类型	必填	说明
identity	string	是	身份名称，最多 50 个字符
remark	string	否	备注，最多 500 个字符

请求示例

curl -X POST https://cookieplus.perk-net.com/api/open/userIdentity/create \
  -H "token: d7b******62f" \
  -H "Content-Type: application/json" \
  -d '{
    "identity": "测试环境",
    "remark": "用于测试环境的账号"
  }'

响应示例

{
  "code": 200,
  "msg": "执行成功",
  "data": 3
}

响应字段

data 为新创建的身份 ID。

---

修改身份

修改已有的用户身份信息。

• URL： /open/userIdentity/update
• 方法： POST
• Content-Type： application/json

请求参数

参数	类型	必填	说明
id	integer	是	身份 ID
identity	string	否	新的身份名称，最多 50 个字符
remark	string	否	新的备注，最多 500 个字符

请求示例

curl -X POST https://cookieplus.perk-net.com/api/open/userIdentity/update \
  -H "token: d7b******62f" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 3,
    "identity": "预发环境",
    "remark": "用于预发环境的账号"
  }'

响应示例

{
  "code": 200,
  "msg": "执行成功",
  "data": {
    "id": 3,
    "identity": "预发环境",
    "remark": "用于预发环境的账号"
  }
}

---

删除身份

删除一个用户身份。

• URL： /open/userIdentity/delete
• 方法： GET

请求参数

参数	类型	必填	说明
id	integer	是	要删除的身份 ID

请求示例

curl "https://cookieplus.perk-net.com/api/open/userIdentity/delete?id=3" \
  -H "token: d7b******62f"

响应示例

{
  "code": 200,
  "msg": "执行成功"
}

警告

删除身份后，该身份下的所有域名和数据也将被清除，此操作不可恢复。