How to set a example value for array/string response type?

[839735495]

Problem statement

I have an API which response type is a string array. Does anyone know how to set example value for it? I tried this but not work:

// Ntp servers
// swagger:response getNtpServersResponse
// Example: ["10.10.10.10", "20.20.20.20"]
type _ []string

// swagger:route GET /ntp-servers
// Responses:
//   200: getNtpServersResponse
//   500: Error
func GetNtpServersHandler() {}

Swagger specification

Without any example:

"getNtpServersResponse": {
    "description": "Ntp servers",
    "content": {
        "*/*": {
            "schema": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            }
        }
    }
},

Environment

swagger version: v0.27.0
go version: go1.19.10
OS: RHEL 8.8

[fredbi]

Here is an example:

go-swagger/fixtures/goparsing/go119/golangnuts.go

Line 24 in 7e78dad

// examples:

[839735495]

Hi @fredbi,
I tried to use swagger:operation to achieve this instead of swagger:route+ swagger:response just like below, which follow the example share by you:

// GetNtpServersHandler
// swagger:operation GET /ntp-servers
// Retrieves the NTP servers
// ---
// responses:
//   '200':
//     description: NTP servers
//     schema:
//       type: array
//       items:
//         type: string
//       example: ["10.10.10.10", "20.20.20.20"]

However, I'd like to know that if there are anyway to set example value to simple "string" or "array" using swagger:response?

// Ntp servers
// swagger:response getNtpServersResponse
type _ []string