证书 API

1. "获取证书列表"

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

2. "添加证书"

  1. route definition
  • Url: /api/v1/certificates
  • Method: POST
  • Request: CertificateAddRequest
  • Response: CertificateAddResponse
  1. request definition
type CertificateAddRequest struct {
	Domain string `json:"domain"`
	Certificate string `json:"certificate,optional"`
	PrivateKey string `json:"privateKey,optional"`
}
  1. response definition
type CertificateAddResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

3. "获取证书详情"

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

4. "删除证书"

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

5. "检查证书状态"

  1. route definition
  • Url: /api/v1/certificates/:id/check
  • Method: POST
  • Request: CertificateCheckRequest
  • Response: CertificateCheckResponse
  1. request definition
type CertificateCheckRequest struct {
	ID string `path:"id"`
}
  1. response definition
type CertificateCheckResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

6. "添加证书告警"

  1. route definition
  • Url: /api/v1/certificates/alerts
  • Method: POST
  • Request: CertificateAlertAddRequest
  • Response: CertificateAlertAddResponse
  1. request definition
type CertificateAlertAddRequest struct {
	Domain string `json:"domain"`
	Threshold int `json:"threshold,optional"`
}
  1. response definition
type CertificateAlertAddResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

7. "获取证书告警列表"

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

8. "检查所有证书"

  1. route definition
  • Url: /api/v1/certificates/check-all
  • Method: POST
  • Request: CertificateCheckAllRequest
  • Response: CertificateCheckAllResponse
  1. request definition
type CertificateCheckAllRequest struct {
}
  1. response definition
type CertificateCheckAllResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

9. "获取域名证书信息"

  1. route definition
  • Url: /api/v1/certificates/domain-info
  • Method: GET
  • Request: CertificateDomainInfoRequest
  • Response: CertificateDomainInfoResponse
  1. request definition
type CertificateDomainInfoRequest struct {
	Domain string `form:"domain"`
}
  1. response definition
type CertificateDomainInfoResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

10. "获取即将过期的证书"

  1. route definition
  • Url: /api/v1/certificates/expiring
  • Method: GET
  • Request: CertificateExpiringRequest
  • Response: CertificateExpiringResponse
  1. request definition
type CertificateExpiringRequest struct {
	Days int `form:"days,optional"`
}
  1. response definition
type CertificateExpiringResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}

11. "获取证书统计"

  1. route definition
  • Url: /api/v1/certificates/stats
  • Method: GET
  • Request: CertificateStatsRequest
  • Response: CertificateStatsResponse
  1. request definition
type CertificateStatsRequest struct {
}
  1. response definition
type CertificateStatsResponse struct {
	Code int `json:"code"`
	Message string `json:"message"`
	Data interface{} `json:"data,omitempty"`
}