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

UserTicketService

工单服务

---

countUserTickets

计算工单数量

• 角色：admin, user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/countUserTickets
• RPC：rpc countUserTickets(CountUserTicketsRequest) returns (RPCCountResponse);

请求对象 (CountUserTicketsRequest)

{
  "userId": "int64 // 用户ID",
  "userTicketCategoryId": "int64",
  "status": "string"
}

响应对象 (RPCCountResponse)

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

调用示例

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

---

createUserTicket

创建工单

• 角色：user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/createUserTicket
• RPC：rpc createUserTicket(CreateUserTicketRequest) returns (CreateUserTicketResponse);

请求对象 (CreateUserTicketRequest)

{
  "userTicketCategoryId": "int64",
  "subject": "string",
  "body": "string"
}

响应对象 (CreateUserTicketResponse)

{
  "userTicketId": "int64"
}

调用示例

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

---

deleteUserTicket

删除工单

• 角色：user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/deleteUserTicket
• RPC：rpc deleteUserTicket(DeleteUserTicketRequest) returns (RPCSuccess);

请求对象 (DeleteUserTicketRequest)

{
  "userTicketId": "int64"
}

响应对象 (RPCSuccess)

{}

调用示例

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

---

findUserTicket

查找单个工单

• 角色：admin, user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/findUserTicket
• RPC：rpc findUserTicket(FindUserTicketRequest) returns (FindUserTicketResponse);

请求对象 (FindUserTicketRequest)

{
  "userTicketId": "int64"
}

响应对象 (FindUserTicketResponse)

{
  "userTicket": "UserTicket"
}

调用示例

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

---

listUserTickets

列出单页工单

• 角色：admin, user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/listUserTickets
• RPC：rpc listUserTickets(ListUserTicketsRequest) returns (ListUserTicketsResponse);

请求对象 (ListUserTicketsRequest)

{
  "userId": "int64 // 用户ID",
  "userTicketCategoryId": "int64",
  "status": "string",
  "offset": "int64 // 读取位置",
  "size": "int64 // 数量，通常不能小于0"
}

响应对象 (ListUserTicketsResponse)

{
  "userTickets": "[]UserTicket"
}

调用示例

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

---

updateUserTicket

修改工单

• 角色：user
• HTTP：POST https://backend.dooki.cloud/UserTicketService/updateUserTicket
• RPC：rpc updateUserTicket(UpdateUserTicketRequest) returns (RPCSuccess);

请求对象 (UpdateUserTicketRequest)

{
  "userTicketId": "int64",
  "userTicketCategoryId": "int64",
  "subject": "string",
  "body": "string"
}

响应对象 (RPCSuccess)

{}

调用示例

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

---