Swagger 是一个特殊的工具，它可以自动组成 RESTful API 你的应用程序的文档。
它的优势在于，它不仅允许你查看应用程序的所有端点，而且还可以通过发送请求和接收响应立即测试它们的运行情况。
要访问 Swagger，你需要在已发布的应用程序中按下 Preview 按钮，然后点击所需发布计划的名称( Deploy Plan).
在新打开的窗口中，会显示可用的端点和与这些端点相关的方法的列表。有些请求只对某些授权用户组可用（见 Middleware 的 Auth module 中每个具体请求的 Endpoints 部分）。A Bearer Token 对于只允许授权用户使用的请求，需要使用A。
你可以直接访问相应的端点，在 Swagger 中的相应端点，以获得该令牌( Auth 节。 POST /auth 请求）。
按 Try it out 并输入登录名和密码以获得令牌。
请求将被发送至 Execute.如果发送成功，你会看到一个 token 字段，其中有 Bearer token 值。
获得授权用户令牌的第二种方式是，可以在部署的应用程序的请求体中找到令牌。
- 在你的网络浏览器中按F12键，打开开发者工具。
- 在你部署的应用程序中发送任何请求（例如，更新表）。发送该请求的用户必须被授权访问该端点。
- 打开 Network 标签并找到相应的请求。
- 转到 Headers 标签，并找到 Request Headers 节。 Bearer token 将呈现在 Authorization.
提供 Bearer token 到 Swagger 按 Authorize 并粘贴你在上一步骤中复制的值。
对于测试请求，选择所需的组和你想执行的方法。按 Try it out 并填写请求的输入参数。点击 Execute 来执行响应。
如果请求被服务器正确处理，最期望的响应是代码200，并显示响应结构应该是什么样子。
-
401 - 该请求没有成功完成，因为所需的授权令牌丢失或无效。
-
404 - 请求被成功处理，但没有找到所请求的资源。
-
422 - 错误的参数被传递到请求的输入端。
-
500 - 服务器处理请求时出现错误。
引起自定义错误
对于自定义BP和相关请求，可以使用BP编辑器中的 Raise Error 块创建带有描述的自定义错误代码。下面是这种过程的一个例子。
在这种情况下，如果对与上述BP相关的端点的请求失败，服务器将发出一个418错误，包含执行BP时的错误文本 DB: Create Candidate block.本例中的错误代码可以是用户指定的任何一个。
注意：HTTP 418 I'm a teapot client error response code表示服务器拒绝冲泡咖啡，因为它是，永久的，一个茶壶。一个暂时没有咖啡的组合咖啡/茶壶应该转而返回503。这个错误是指1998年和2014年愚人节笑话中定义的Hyper Text Coffee Pot Control Protocol 。
