how can i generate spec with a simple string response

[hunjixin]

Problem statement

when api success, just response with a string value, but swagger simple cannt identy a simple string

Swagger specification

// swagger:route GET /version getVersion
//
// get backend version
//
//     Consumes:
//
//     Produces:
//     - application/text
//
//     Schemes: http, https
//
//     Deprecated: false
//
//     Responses:
//       200: string

and got spec like

   "responses": {
          "200": {
            "$ref": "#/responses/string"
          }
        }

Environment

swagger version: master
go version: go1.19.8
OS: mac

[casualjim]

By default it wants you to specify headers and body. But you can prefix the response type with body: and then it will do the right thing

// swagger:route GET /version getVersion
//
// get backend version
//
//     Consumes:
//
//     Produces:
//     - application/text
//
//     Schemes: http, https
//
//     Deprecated: false
//
//     Responses:
//       200: body:string

[hunjixin]

@casualjim thanks, but where can i find docs about this?

[hunjixin]

@casualjim not work

        "responses": {
          "200": {
            "description": "string",
            "schema": {
              "$ref": "#/definitions/string"
            }
          }
        }

when use this spec to generate client, got error

unsupported type "invalid type"