文档标题中不存在邮递员集合授权

Posted 2023-03-10

【中文标题】文档标题中不存在邮递员集合授权

【英文标题】：Postman collection Authorization not present in documentation headers

【发布时间】：2018-11-29 03:08:22

【问题描述】：

我已经开始使用 Postman 来绘制我的 API，并且还希望有一种快速、简单的方法来记录和分享它。

我的 API 使用 JWT 进行身份验证，并且此令牌需要出现在除登录之外的每个请求中。

为了保持干燥，我使用了 Postman 收集授权 正如他们的博客 http://blog.getpostman.com/2017/12/13/keep-it-dry-with-collection-and-folder-elements/

中所解释的那样

Example of how I set up collection authorization type bearer

我的 API 将这个标头用作“从父级继承身份验证”类型，这在我的请求期间没有问题。

但是，如果我选择在浏览器中查看集合，则此标头不会显示在请求中或示例中请参见屏幕截图。

Collection documentation as viewed in web

这是 Postman 中的 cURL 请求： curl -X GET \ https://example.api/v1/auth/user \ -H 'Content-Type: application/json'

是否可以在使用集合设置时显示 auth 标头，或者我应该为每个请求自己添加标头，以确保将其添加到示例和文档中？ p>

编辑： 我发现如果我将鼠标悬停在 Authorization 标题上，我会收到以下消息：

此临时标头由 Postman 生成，不会随您的请求一起保存。

Here is a screenshot from the app with Postman collection temporary headers.

【问题讨论】：

我也有同样的问题。已经在他们的论坛上发布并提交了支持票。你最后找到解决办法了吗？

没有解决方案，但我在描述/介绍中提到，授权标头应该出现在每个请求中，登录为异常。

我不确定我会说些什么有价值的东西，所以我将粘贴为评论而不是答案。你找过你的临时标题吗？你启用它们了吗？看看community.getpostman.com/t/temporary-headers/5243

【参考方案1】：

如果您将该 JWT 令牌设置为请求标头，那么它应该显示在文档中。以下是我如何生成和设置 jwt 令牌的步骤：

登录api生成jwt token。 将该令牌保存为环境 变量 在需要的每个请求中使用该变量 授权标头。

请看截图

【讨论】：

如您所说，此方法要求每个请求都定义授权标头。目前我在收藏级别有这个设置。似乎邮递员最后更新了一些东西。至少现在 auth 下的每个端点都会显示以下消息：“此请求正在使用集合 中的授权助手”

【参考方案2】：

此问题将在 2 或 3 次安装后得到解决。

您可以在https://github.com/postmanlabs/postman-app-support/projects/40#card-33062423跟踪问题状态