180 lines
8.2 KiB
Plaintext
180 lines
8.2 KiB
Plaintext
syntax = "v1"
|
||
|
||
info (
|
||
title: "投诉管理服务"
|
||
desc: "投诉管理相关接口"
|
||
version: "v1"
|
||
)
|
||
|
||
@server (
|
||
prefix: api/v1/admin/complaint
|
||
group: admin_complaint
|
||
middleware: AdminAuthInterceptor
|
||
)
|
||
service main {
|
||
@doc "获取投诉列表"
|
||
@handler AdminGetComplaintList
|
||
get /list (AdminGetComplaintListReq) returns (AdminGetComplaintListResp)
|
||
|
||
@doc "获取投诉详情"
|
||
@handler AdminGetComplaintDetail
|
||
get /detail/:id (AdminGetComplaintDetailReq) returns (AdminGetComplaintDetailResp)
|
||
|
||
@doc "更新投诉状态"
|
||
@handler AdminUpdateComplaintStatus
|
||
put /update-status/:id (AdminUpdateComplaintStatusReq) returns (AdminUpdateComplaintStatusResp)
|
||
|
||
@doc "更新投诉备注"
|
||
@handler AdminUpdateComplaintRemark
|
||
put /update-remark/:id (AdminUpdateComplaintRemarkReq) returns (AdminUpdateComplaintRemarkResp)
|
||
}
|
||
|
||
type (
|
||
// 列表请求
|
||
AdminGetComplaintListReq {
|
||
Page int64 `form:"page,default=1"` // 页码
|
||
PageSize int64 `form:"pageSize,default=20"` // 每页数量
|
||
Type string `form:"type,optional"` // 投诉类型：alipay-支付宝投诉，manual-主动投诉
|
||
Status string `form:"status,optional"` // 投诉状态：pending-待处理，processing-处理中，resolved-已解决，closed-已关闭
|
||
Name string `form:"name,optional"` // 投诉人姓名
|
||
Contact string `form:"contact,optional"` // 联系方式
|
||
OrderId string `form:"order_id,optional"` // 关联订单ID
|
||
CreateTimeStart string `form:"create_time_start,optional"` // 创建时间开始
|
||
CreateTimeEnd string `form:"create_time_end,optional"` // 创建时间结束
|
||
HandleTimeStart string `form:"handle_time_start,optional"` // 处理时间开始
|
||
HandleTimeEnd string `form:"handle_time_end,optional"` // 处理时间结束
|
||
}
|
||
|
||
// 列表响应
|
||
AdminGetComplaintListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []ComplaintListItem `json:"items"` // 列表
|
||
}
|
||
|
||
// 列表项
|
||
ComplaintListItem {
|
||
Id string `json:"id"` // 投诉ID
|
||
Type string `json:"type"` // 投诉类型：alipay-支付宝投诉，manual-主动投诉
|
||
OrderId string `json:"order_id"` // 关联订单ID
|
||
Name string `json:"name"` // 投诉人姓名
|
||
Contact string `json:"contact"` // 联系方式
|
||
Content string `json:"content"` // 投诉内容
|
||
Status string `json:"status"` // 投诉状态
|
||
StatusDescription string `json:"status_description"` // 状态描述
|
||
Remark string `json:"remark"` // 处理备注
|
||
HandlerId string `json:"handler_id"` // 处理人ID
|
||
HandleTime string `json:"handle_time"` // 处理时间
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
UpdateTime string `json:"update_time"` // 更新时间
|
||
// 支付宝投诉特有字段
|
||
TaskId string `json:"task_id"` // 支付宝投诉单号
|
||
TradeNo string `json:"trade_no"` // 支付宝交易单号
|
||
ComplainAmount string `json:"complain_amount"` // 投诉金额
|
||
GmtComplain string `json:"gmt_complain"` // 投诉时间
|
||
// 主动投诉特有字段
|
||
Subject string `json:"subject"` // 投诉主题
|
||
Priority string `json:"priority"` // 优先级
|
||
Source string `json:"source"` // 投诉来源
|
||
}
|
||
|
||
// 详情请求
|
||
AdminGetComplaintDetailReq {
|
||
Id string `path:"id"` // 投诉ID
|
||
}
|
||
|
||
// 详情响应
|
||
AdminGetComplaintDetailResp {
|
||
Id string `json:"id"` // 投诉ID
|
||
Type string `json:"type"` // 投诉类型：alipay-支付宝投诉，manual-主动投诉
|
||
OrderId string `json:"order_id"` // 关联订单ID
|
||
Name string `json:"name"` // 投诉人姓名
|
||
Contact string `json:"contact"` // 联系方式
|
||
Content string `json:"content"` // 投诉内容
|
||
Status string `json:"status"` // 投诉状态
|
||
StatusDescription string `json:"status_description"` // 状态描述
|
||
Remark string `json:"remark"` // 处理备注
|
||
HandlerId string `json:"handler_id"` // 处理人ID
|
||
HandleTime string `json:"handle_time"` // 处理时间
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
UpdateTime string `json:"update_time"` // 更新时间
|
||
// 支付宝投诉详情
|
||
AlipayComplaint *AlipayComplaintDetail `json:"alipay_complaint,optional"` // 支付宝投诉详情
|
||
// 主动投诉详情
|
||
ManualComplaint *ManualComplaintDetail `json:"manual_complaint,optional"` // 主动投诉详情
|
||
}
|
||
|
||
// 支付宝投诉详情
|
||
AlipayComplaintDetail {
|
||
Id string `json:"id"` // 支付宝投诉表ID
|
||
AlipayId int64 `json:"alipay_id"` // 支付宝投诉主表的主键id
|
||
TaskId string `json:"task_id"` // 投诉单号id
|
||
OppositePid string `json:"opposite_pid"` // 被投诉人pid
|
||
OppositeName string `json:"opposite_name"` // 被投诉方名称
|
||
ComplainAmount string `json:"complain_amount"` // 投诉单涉及交易总金额
|
||
GmtComplain string `json:"gmt_complain"` // 投诉时间
|
||
GmtProcess string `json:"gmt_process"` // 处理时间
|
||
GmtOverdue string `json:"gmt_overdue"` // 过期时间
|
||
ComplainContent string `json:"complain_content"` // 用户投诉内容
|
||
TradeNo string `json:"trade_no"` // 投诉交易单号
|
||
Status string `json:"status"` // 投诉状态
|
||
StatusDescription string `json:"status_description"` // 投诉单状态枚举值描述
|
||
ProcessCode string `json:"process_code"` // 商家处理结果码
|
||
ProcessMessage string `json:"process_message"` // 商家处理结果码对应描述
|
||
ProcessRemark string `json:"process_remark"` // 商家处理备注
|
||
ProcessImgUrlList []string `json:"process_img_url_list"` // 商家处理备注图片url列表
|
||
GmtRiskFinishTime string `json:"gmt_risk_finish_time"` // 推送时间
|
||
ComplainUrl string `json:"complain_url"` // 投诉网址
|
||
CertifyInfo []string `json:"certify_info"` // 投诉凭证图片信息
|
||
TradeInfoList []AlipayComplaintTradeInfo `json:"trade_info_list"` // 交易信息列表
|
||
}
|
||
|
||
// 支付宝投诉交易信息
|
||
AlipayComplaintTradeInfo {
|
||
Id string `json:"id"` // 交易信息表ID
|
||
AlipayTradeId string `json:"alipay_trade_id"` // 交易信息表主键id
|
||
AlipayComplaintRecordId string `json:"alipay_complaint_record_id"` // 投诉主表id
|
||
TradeNo string `json:"trade_no"` // 支付宝交易单号
|
||
OutNo string `json:"out_no"` // 商家订单号
|
||
GmtTrade string `json:"gmt_trade"` // 交易时间
|
||
GmtRefund string `json:"gmt_refund"` // 退款时间
|
||
Status string `json:"status"` // 交易投诉状态
|
||
StatusDescription string `json:"status_description"` // 交易投诉状态描述
|
||
Amount string `json:"amount"` // 交易单金额
|
||
}
|
||
|
||
// 主动投诉详情
|
||
ManualComplaintDetail {
|
||
Id string `json:"id"` // 主动投诉表ID
|
||
UserId string `json:"user_id"` // 关联用户ID
|
||
Subject string `json:"subject"` // 投诉主题
|
||
Priority string `json:"priority"` // 优先级：low-低，medium-中，high-高，urgent-紧急
|
||
Source string `json:"source"` // 投诉来源：web-网站，phone-电话，email-邮件，other-其他
|
||
AttachmentUrls []string `json:"attachment_urls"` // 附件URL列表
|
||
}
|
||
|
||
// 更新投诉状态请求
|
||
AdminUpdateComplaintStatusReq {
|
||
Id string `path:"id"` // 投诉ID
|
||
Status string `json:"status"` // 投诉状态：pending-待处理，processing-处理中，resolved-已解决，closed-已关闭
|
||
StatusDescription string `json:"status_description,optional"` // 状态描述
|
||
HandlerId string `json:"handler_id,optional"` // 处理人ID
|
||
}
|
||
|
||
// 更新投诉状态响应
|
||
AdminUpdateComplaintStatusResp {
|
||
Success bool `json:"success"` // 是否成功
|
||
}
|
||
|
||
// 更新投诉备注请求
|
||
AdminUpdateComplaintRemarkReq {
|
||
Id string `path:"id"` // 投诉ID
|
||
Remark string `json:"remark"` // 处理备注
|
||
}
|
||
|
||
// 更新投诉备注响应
|
||
AdminUpdateComplaintRemarkResp {
|
||
Success bool `json:"success"` // 是否成功
|
||
}
|
||
)
|
||
|