Appearance
实体 API
1. "获取实体列表"
- route definition
- Url: /api/v1/entities
- Method: GET
- Request:
EntitiesListRequest - Response:
EntitiesListResponse
- request definition
go
type EntitiesListRequest struct {
Page int `form:"page,optional"`
PageSize int `form:"pageSize,optional"`
Type string `form:"type,optional"`
}- response definition
go
type EntitiesListResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}2. "创建实体"
- route definition
- Url: /api/v1/entities
- Method: POST
- Request:
EntityCreateRequest - Response:
EntityCreateResponse
- request definition
go
type EntityCreateRequest struct {
Type string `json:"type"`
Data interface{} `json:"data"`
}- response definition
go
type EntityCreateResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}3. "获取实体详情"
- route definition
- Url: /api/v1/entities/:id
- Method: GET
- Request:
EntityDetailRequest - Response:
EntityDetailResponse
- request definition
go
type EntityDetailRequest struct {
ID string `path:"id"`
}- response definition
go
type EntityDetailResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}4. "更新实体"
- route definition
- Url: /api/v1/entities/:id
- Method: PUT
- Request:
EntityUpdateRequest - Response:
EntityUpdateResponse
- request definition
go
type EntityUpdateRequest struct {
ID string `path:"id"`
Data interface{} `json:"data"`
}- response definition
go
type EntityUpdateResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}5. "删除实体"
- route definition
- Url: /api/v1/entities/:id
- Method: DELETE
- Request:
EntityDeleteRequest - Response:
EntityDeleteResponse
- request definition
go
type EntityDeleteRequest struct {
ID string `path:"id"`
}- response definition
go
type EntityDeleteResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}6. "预览实体"
- route definition
- Url: /api/v1/entities/:id/preview
- Method: GET
- Request:
EntityPreviewRequest - Response:
EntityPreviewResponse
- request definition
go
type EntityPreviewRequest struct {
ID string `path:"id"`
}- response definition
go
type EntityPreviewResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}7. "验证实体"
- route definition
- Url: /api/v1/entities/validate
- Method: POST
- Request:
EntityValidateRequest - Response:
EntityValidateResponse
- request definition
go
type EntityValidateRequest struct {
Type string `json:"type"`
Data interface{} `json:"data"`
}- response definition
go
type EntityValidateResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}