如何用名稱但沒有值定義查詢參數？

Question

我的，看起來像這樣的URL創建揚鞭文檔：

mysite.local.com/mylink?callback&service=someservicename&currency=USD 

正如你所看到的，在查詢字符串的callback參數有一個名字，但沒有價值。我如何在Swagger中描述這個參數？

下面是我使用的YAML代碼：

swagger: "2.0" 
info: 
title: My API 
description: Documentation of webservices Used 
version: 1.0.0 

host: mysite.local.com 
basePath:/
schemes: 
- https 

paths: 
/mylink: 
    get: 
    summary: sometext 
    description: Optional extended description in Markdown. 
    produces: 
     - application/json 
    responses: 
     200: 
     description: OK 
    parameters: 
     callback: 

Answer 1

我在，你可以指定一個參數，那就是在「查詢」的doc發現，但我敢肯定你得給它一個值（即：回調=真）

例子：

paths: 
/mylink: 
    get: 
    summary: sometext 
    description: Optional extended description in Markdown. 
    produces: 
     - application/json 
    responses: 
     200: 
     description: OK 
    parameters: 
     - name: callback 
     in: query 
     type: boolean