wwweww
54 lines
1.7 KiB
Plaintext
54 lines
1.7 KiB
Plaintext
syntax = "v1"
|
|
|
|
info (
|
|
title: "聚玩认证审核服务"
|
|
desc: "处理用户角色认证申请（打手/店长）及管理员审核流程"
|
|
author: "Asadz"
|
|
version: "1.0"
|
|
)
|
|
|
|
// =================================================================================
|
|
// 数据结构定义 (Data Structures)
|
|
// =================================================================================
|
|
|
|
// =================================================================================
|
|
// 用户端接口 (User Side)
|
|
// 路径前缀: /api/v1/users
|
|
// =================================================================================
|
|
@server (
|
|
group: verification_user
|
|
prefix: /api/v1/users
|
|
)
|
|
service verification-api {
|
|
@doc "提交或修改角色认证申请 (支持幂等更新)"
|
|
@handler ApplyVerification
|
|
post /me/verification (ApplyVerificationReq) returns (VerificationEmptyResp)
|
|
|
|
@doc "获取我的所有认证状态"
|
|
@handler GetMyVerifications
|
|
get /me/verification returns (GetMyVerificationsResp)
|
|
}
|
|
|
|
// =================================================================================
|
|
// 管理端接口 (Admin Side)
|
|
// 路径前缀: /api/v1/admin
|
|
// =================================================================================
|
|
@server (
|
|
group: verification_admin
|
|
prefix: /api/v1/admin
|
|
)
|
|
service verification-api {
|
|
@doc "管理员获取认证申请列表 (分页)"
|
|
@handler GetVerifications
|
|
get /verifications (GetPendingListReq) returns (GetPendingListResp)
|
|
|
|
@doc "管理员通过申请"
|
|
@handler ApproveVerification
|
|
post /verifications/:id/approve (VerificationIdReq) returns (VerificationEmptyResp)
|
|
|
|
@doc "管理员驳回申请"
|
|
@handler RejectVerification
|
|
post /verifications/:id/reject (RejectVerificationReq) returns (VerificationEmptyResp)
|
|
}
|
|
|