支持 API

1. "获取FAQ列表"

  1. route definition
  • Url: /api/v1/support/faq
  • Method: GET
  • Request: SupportFAQListRequest
  • Response: SupportFAQListResponse
  1. request definition
type SupportFAQListRequest struct {
	Category string `form:"category,optional"`
}
  1. response definition
type SupportFAQListResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

2. "创建FAQ"

  1. route definition
  • Url: /api/v1/support/faq
  • Method: POST
  • Request: SupportFAQCreateRequest
  • Response: SupportFAQCreateResponse
  1. request definition
type SupportFAQCreateRequest struct {
	Category string `json:"category"`
	Question string `json:"question"`
	Answer string `json:"answer"`
}
  1. response definition
type SupportFAQCreateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

3. "更新FAQ"

  1. route definition
  • Url: /api/v1/support/faq/:id
  • Method: PUT
  • Request: SupportFAQUpdateRequest
  • Response: SupportFAQUpdateResponse
  1. request definition
type SupportFAQUpdateRequest struct {
	ID string `path:"id"`
	Category string `json:"category,optional"`
	Question string `json:"question,optional"`
	Answer string `json:"answer,optional"`
}
  1. response definition
type SupportFAQUpdateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

4. "删除FAQ"

  1. route definition
  • Url: /api/v1/support/faq/:id
  • Method: DELETE
  • Request: SupportFAQDeleteRequest
  • Response: SupportFAQDeleteResponse
  1. request definition
type SupportFAQDeleteRequest struct {
	ID string `path:"id"`
}
  1. response definition
type SupportFAQDeleteResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

5. "获取反馈列表"

  1. route definition
  • Url: /api/v1/support/feedback
  • Method: GET
  • Request: SupportFeedbackListRequest
  • Response: SupportFeedbackListResponse
  1. request definition
type SupportFeedbackListRequest struct {
	Page int `form:"page,optional"`
	PageSize int `form:"pageSize,optional"`
}
  1. response definition
type SupportFeedbackListResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

6. "创建反馈"

  1. route definition
  • Url: /api/v1/support/feedback
  • Method: POST
  • Request: SupportFeedbackCreateRequest
  • Response: SupportFeedbackCreateResponse
  1. request definition
type SupportFeedbackCreateRequest struct {
	Type string `json:"type"`
	Content string `json:"content"`
}
  1. response definition
type SupportFeedbackCreateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

7. "更新反馈"

  1. route definition
  • Url: /api/v1/support/feedback/:id
  • Method: PUT
  • Request: SupportFeedbackUpdateRequest
  • Response: SupportFeedbackUpdateResponse
  1. request definition
type SupportFeedbackUpdateRequest struct {
	ID string `path:"id"`
	Status string `json:"status,optional"`
	Comment string `json:"comment,optional"`
}
  1. response definition
type SupportFeedbackUpdateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

8. "删除反馈"

  1. route definition
  • Url: /api/v1/support/feedback/:id
  • Method: DELETE
  • Request: SupportFeedbackDeleteRequest
  • Response: SupportFeedbackDeleteResponse
  1. request definition
type SupportFeedbackDeleteRequest struct {
	ID string `path:"id"`
}
  1. response definition
type SupportFeedbackDeleteResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

9. "获取工单列表"

  1. route definition
  • Url: /api/v1/support/tickets
  • Method: GET
  • Request: SupportTicketsListRequest
  • Response: SupportTicketsListResponse
  1. request definition
type SupportTicketsListRequest struct {
	Page int `form:"page,optional"`
	PageSize int `form:"pageSize,optional"`
	Status string `form:"status,optional"`
}
  1. response definition
type SupportTicketsListResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

10. "创建工单"

  1. route definition
  • Url: /api/v1/support/tickets
  • Method: POST
  • Request: SupportTicketCreateRequest
  • Response: SupportTicketCreateResponse
  1. request definition
type SupportTicketCreateRequest struct {
	Subject string `json:"subject"`
	Content string `json:"content"`
}
  1. response definition
type SupportTicketCreateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

11. "获取工单详情"

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

12. "更新工单"

  1. route definition
  • Url: /api/v1/support/tickets/:id
  • Method: PUT
  • Request: SupportTicketUpdateRequest
  • Response: SupportTicketUpdateResponse
  1. request definition
type SupportTicketUpdateRequest struct {
	ID string `path:"id"`
	Subject string `json:"subject,optional"`
	Content string `json:"content,optional"`
}
  1. response definition
type SupportTicketUpdateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

13. "删除工单"

  1. route definition
  • Url: /api/v1/support/tickets/:id
  • Method: DELETE
  • Request: SupportTicketDeleteRequest
  • Response: SupportTicketDeleteResponse
  1. request definition
type SupportTicketDeleteRequest struct {
	ID string `path:"id"`
}
  1. response definition
type SupportTicketDeleteResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

14. "工单状态转换"

  1. route definition
  • Url: /api/v1/support/tickets/:id/transition
  • Method: POST
  • Request: SupportTicketTransitionRequest
  • Response: SupportTicketTransitionResponse
  1. request definition
type SupportTicketTransitionRequest struct {
	ID string `path:"id"`
	Status string `json:"status"`
}
  1. response definition
type SupportTicketTransitionResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

15. "获取工单评论"

  1. route definition
  • Url: /api/v1/support/tickets/:ticketId/comments
  • Method: GET
  • Request: SupportCommentsListRequest
  • Response: SupportCommentsListResponse
  1. request definition
type SupportCommentsListRequest struct {
	TicketID string `path:"ticketId"`
	Page int `form:"page,optional"`
	PageSize int `form:"pageSize,optional"`
}
  1. response definition
type SupportCommentsListResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

16. "创建工单评论"

  1. route definition
  • Url: /api/v1/support/tickets/:ticketId/comments
  • Method: POST
  • Request: SupportCommentCreateRequest
  • Response: SupportCommentCreateResponse
  1. request definition
type SupportCommentCreateRequest struct {
	TicketID string `path:"ticketId"`
	Content string `json:"content"`
}
  1. response definition
type SupportCommentCreateResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}