pyGoEdge-UserPanel/reference/goedge 文档/UserAccountService.md

UserAccountService

用户账户服务

---

countUserAccounts

计算账户数量

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/UserAccountService/countUserAccounts
• RPC：rpc countUserAccounts(CountUserAccountsRequest) returns (RPCCountResponse);

请求对象 (CountUserAccountsRequest)

{
  "keyword": "string // 关键词"
}

响应对象 (RPCCountResponse)

{
  "count": "int64 // 数量"
}

调用示例

curl -X POST "https://backend.dooki.cloud/UserAccountService/countUserAccounts" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findEnabledUserAccount

查找单个账户

• 角色：admin, user
• HTTP：POST https://backend.dooki.cloud/UserAccountService/findEnabledUserAccount
• RPC：rpc findEnabledUserAccount(FindEnabledUserAccountRequest) returns (FindEnabledUserAccountResponse);

请求对象 (FindEnabledUserAccountRequest)

{
  "userAccountId": "int64 // 用户账户ID"
}

响应对象 (FindEnabledUserAccountResponse)

{
  "userAccount": "UserAccount // 用户账户"
}

调用示例

curl -X POST "https://backend.dooki.cloud/UserAccountService/findEnabledUserAccount" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findEnabledUserAccountWithUserId

根据用户ID查找单个账户

• 角色：admin, user
• HTTP：POST https://backend.dooki.cloud/UserAccountService/findEnabledUserAccountWithUserId
• RPC：rpc findEnabledUserAccountWithUserId(FindEnabledUserAccountWithUserIdRequest) returns (FindEnabledUserAccountWithUserIdResponse);

请求对象 (FindEnabledUserAccountWithUserIdRequest)

{
  "userId": "int64 // 用户ID"
}

响应对象 (FindEnabledUserAccountWithUserIdResponse)

{
  "userAccount": "UserAccount // 用户账户"
}

调用示例

curl -X POST "https://backend.dooki.cloud/UserAccountService/findEnabledUserAccountWithUserId" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

listUserAccounts

列出单页账户

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/UserAccountService/listUserAccounts
• RPC：rpc listUserAccounts(ListUserAccountsRequest) returns (ListUserAccountsResponse);

请求对象 (ListUserAccountsRequest)

{
  "keyword": "string // 关键词",
  "offset": "int64 // 读取位置",
  "size": "int64 // 数量，通常不能小于0"
}

响应对象 (ListUserAccountsResponse)

{
  "userAccounts": "[]UserAccount // 用户账户列表"
}

调用示例

curl -X POST "https://backend.dooki.cloud/UserAccountService/listUserAccounts" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

updateUserAccount

修改用户账户

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/UserAccountService/updateUserAccount
• RPC：rpc updateUserAccount(UpdateUserAccountRequest) returns (RPCSuccess);

请求对象 (UpdateUserAccountRequest)

{
  "userAccountId": "int64 // 用户账户ID（非用户ID）",
  "delta": "double // 操作的数值，正值表示增加，负值表示减少",
  "eventType": "string // 事件类型：charge, award, buyPlan, payBill, refund, withdraw, buyNSPlan, buyTrafficPackage, buyAntiDDoSPackage, renewAntiDDoSPackage",
  "description": "string // 描述",
  "paramsJSON": "bytes // 相关参数"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/UserAccountService/updateUserAccount" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---