在 API 蓝图中记录互斥查询参数

Question

我正在记录一个公共 API，该 API 有一个名为 /findGuild 的方法，该方法采用强制性 key 参数和以下参数之一：

1. byPlayer
2. byName

它必须有byPlayer或byName；我的问题是：我如何表明byPlayer 和byName 是互斥的，但必须有一个？

---

现在，我的.apib 中有以下资源：

### GET /findGuild{?byName,byPlayer,key}

+ Parameters
  + byName: `YourGuild` (string, optional) - Search for the Guild by its name.
  + byPlayer: (string, optional) -  Search for Guild by a player. Does not seem to work.
  + key: `ffffffff-ffff-ffff-ffff-ffffffffffff` (string, required) - The user's API key.

+ Response 200 (application/json)

    + Attributes (object)
      + guild (string) - The guild id or null.
      + success (boolean) - Should be true.

    + Body

            {
              "guild": "ffffffffffffffffffffffff",
              "success": true
            }

Answer 1

恐怕（但不完全确定）API Blueprint 目前无法表达这种关系。

我可以肯定地告诉你的是，根据public roadmap，URI 参数将被替换为MSON object，它支持你要求的scenario。

希望对你有帮助！