// Configure the models.
api := openapi.NewAPI("messages")
api.StripPkgPaths = []string{"github.com/ihezebin/openapi/example", "github.com/a-h/respond"}

api.Get("/topic/{id}").
  HasPathParameter("id", openapi.PathParam{
   Description: "id of the topic",
   Regexp:      `\d+`,
  }).
  HasResponseModel(http.StatusOK, openapi.ModelOf[models.Body[models.Topic]]()).
  HasResponseModel(http.StatusInternalServerError, openapi.ModelOf[models.Body[map[string]string]]()).
  HasTags([]string{"Topic"}).
  HasDescription("Get one topic by id").
  HasSummary("getOneTopic").
  HasHeaderParameter("Authorization", openapi.HeaderParam{
   Description: "Bearer token",
   Required:    true,
   Type:        openapi.PrimitiveTypeString,
  }).
  HasQueryParameter("limit", openapi.QueryParam{
   Description: "limit",
   Required:    true,
  }).
  HasResponseHeader(http.StatusOK, "Token", openapi.HeaderParam{
   Description: "token",
   Required:    true,
   Type:        openapi.PrimitiveTypeString,
  }).HasDeprecated(true)

api.Json()