审批 API

1. "获取审批列表"

  1. route definition
  • Url: /api/v1/approvals
  • Method: GET
  • Request: ApprovalsListRequest
  • Response: ApprovalsListResponse
  1. request definition
type ApprovalsListRequest struct {
	Page int `form:"page,optional"` // 页码
	PageSize int `form:"pageSize,optional"` // 每页数量
	Status string `form:"status,optional"` // 状态过滤
}
  1. response definition
type ApprovalsListResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

2. "获取审批详情"

  1. route definition
  • Url: /api/v1/approvals/:id
  • Method: GET
  • Request: ApprovalGetRequest
  • Response: ApprovalGetResponse
  1. request definition
type ApprovalGetRequest struct {
	ID string `path:"id"` // 审批ID
}
  1. response definition
type ApprovalGetResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

3. "通过审批"

  1. route definition
  • Url: /api/v1/approvals/:id/approve
  • Method: POST
  • Request: ApprovalApproveRequest
  • Response: ApprovalApproveResponse
  1. request definition
type ApprovalApproveRequest struct {
	ID string `path:"id"` // 审批ID
}
  1. response definition
type ApprovalApproveResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

4. "拒绝审批"

  1. route definition
  • Url: /api/v1/approvals/:id/reject
  • Method: POST
  • Request: ApprovalRejectRequest
  • Response: ApprovalRejectResponse
  1. request definition
type ApprovalRejectRequest struct {
	ID string `path:"id"` // 审批ID
	Reason string `json:"reason"` // 拒绝原因
}
  1. response definition
type ApprovalRejectResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}