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"` // 是否成功
|
|||
|
|
}
|
|||
|
|
)
|
|||
|
|
|