使用路径参数 Swagger

Question

路线:

// swagger:route DELETE /v1/path/{id} api DeleteV1
//
// Deletes an item.
//
//     Schemes: https
//
//     Responses:
//       202: AcceptedResponse
//       401: UnauthorizedErrorResponse
//       500: InternalServerErrorResponse
"/v1/path/{id}": {
    "DELETE":  Handle(DeleteRequest{}),
    "OPTIONS": s.handleOptionsRequest,
},

参数/响应模型:

// Description
//
// swagger:parameters DeleteV1
type DeleteRequest struct {
    // id of an item
    //
    // In: path
    id string `json:"id"`

    cookies  []*http.Cookie
}

// Description
//
// swagger:response DeleteResponse
type DeleteResponse struct {
}

无论我怎样尝试，我总是得到 - path param "{id}"has no parameter definition。

端点仅采用路径参数“id”、cookie(它们在 swagger 模型中不可见)并返回空主体和 HTTP 状态代码。

如何让 go-swagger 看到“{id}”的“参数定义”？

Answer 1

需要导出struct字段。尝试:

type DeleteRequest struct {
    // ID of an item
    //
    // In: path
    ID string `json:"id"`