Postman(API开发协作平台) v7.1.0 官方版

　　Postman是一非常强大的API测试套件，这款软件已经成为许多开发人员的必备工具，它可以构建良好的API并提高开发人员的工作效率；这款软件兼容目前使用的多种编程语言，因此用户无需重新学习新的语言；这款软件最初是作为谷歌浏览器的扩展插件使用的，而今天推荐的这个软件是一个独立的客户端，它能够实现跨平台部署和运行，用户可以使用谷歌账户登录使用；Postman拥有许多实用且强大的功能，通过这款工具可以快速帮助您分析API以及发现API的错误；总而言之这款工具对需要开发API项目的用户是非常有用的，需要的朋友欢迎下载使用。

软件功能

　　缩短生产时间

　　与Postman的API模拟服务器一起更有效地工作，Postman模拟支持拆分堆栈开发，因此前端和后端开发人员可以并行工作并查看响应，而无需增加后端。

　　通过灵活的架构支持设计API

　　Postman模拟服务器是对Postman扩展架构支持的补充。编写，编辑或导入API模式，以定义API的数据结构并从API模式生成集合。您可以使用模拟服务器查看API响应，从而可以在一个中央位置可靠地重新构建API。

　　模拟您的API的预期行为

　　邮递员模拟服务器模拟API响应，即使在构建API之前，应用程序和服务也可以利用这些响应。邮递员会匹配请求并生成响应，以向您展示您的API如何在生产环境中运行。

　　尽早发现并修复错误

　　模拟服务器提高了对API中的错误和薄弱环节的可见性，因此您可以高效地进行调试。您可以轻松地使用模拟服务器来连续或在整个API生命周期中根据需要测试响应错误。

　　在邮递员中创建公共或专用模拟服务器

　　邮递员提供两种不同类型的模拟服务器。公共模拟服务器非常适合开放源代码或单个项目，但是，如果您使用内部或私有API，则可以通过使用私有模拟服务器查看API响应来轻松确保API的安全。

　　可视化您的数据

　　Postman Visualizer可以帮助您将API数据转换为图表。与Postman模拟程序结合使用，开发人员可以利用Visualizer帮助API使用者更轻松地理解API响应。

　　借助自动化测试，轻松扩展规模。

　　随着程序的增长，损坏的风险也在增加。您可以通过增加测试的覆盖范围和频率来创建更强大且更可靠的程序。Postman和Newman，我们的命令行工具，使您可以轻松地设置自己的自动化测试。

软件特色

　　自动更新您的文档

　　永远不要让您的文档再次落后于服务。每当您对馆藏进行更改时，Postman都会自动更新您的文档-实时。

　　使用“邮递员运行”按钮轻松共享

　　在几秒钟内分享您的收藏。在您的文档页面或任何其他网站中嵌入“在邮递员中运行”按钮，以允许任何人一键导入您的收藏集。

　　获得您的API的采用

　　如果您使用API，您将知道传达使用说明的重要文档。Postman文档是机器可读的，因此任何人（开发人员，测试人员，产品经理或合作伙伴）都可以通过其Postman实例直接使用您的API。

　　与您的团队就文档进行协作

　　Postman的评论功能使您和您的团队可以通过评论和代码评论共享反馈。您可以轻松地组织和通知团队成员有关更改或错误的信息，从而可以向用户提供最佳的文档。

官方教程

　　添加自定义域

　　在Postman Web仪表板中，从“团队”选项卡中选择“ 团队设置”。

　　在“自定义域”部分，您将看到一个带有验证状态的域列表。单击+添加新域。

　　在“添加自定义域”页面中，输入要添加的域的URL。您的自定义域可以是完整域或子域。例如，您可以使用example.com或api.example.com。

　　单击继续以验证域。

　　验证您的网域

　　添加自定义域时，您将看到一个模式，显示验证域所有权所需的DNS记录。要验证您是否控制要添加的域，必须将这些提供的令牌作为DNS记录添加到TXT和CNAME的域中。

　　添加DNS记录

　　对于DNS记录，请与DNS Web服务提供商一起验证所有权。在一个单独的浏览器选项卡中，转到DNS提供程序的控制台，并添加以下两个新记录。

　　用于postman-echo.com验证域所有权的TXT记录。该值应与模式中显示的令牌相同。将TXT记录添加到根域。例如，如果您要添加example.com或api.example.com，则将TXT记录添加到中example.com。

　　的CNAME记录docs.postman-echo.com（如模式中所示）应为phs.getpostman.com。将CNAME记录添加到与您的公共文档关联的URL。

　　要验证域，请选中我已添加TXT和CNAME记录复选框，然后点击验证域。确认消息应表明该域已被验证。

　　邮递员将LetsEncrypt用作SSL证书提供程序，以在您的域上托管公共文档。如果您的域中没有CAA记录，则LetsEncrypt会隐式生成证书。如果您的域设置了CAA记录，则LetsEncrypt需要明确的CAA记录来为该域颁发证书。要启用LetsEncrypt颁发此证书，请参阅LetsEncrypt文档。

　　如果您不想立即验证域，请点击稍后验证。

　　您可以通过单击“删除自定义域”来删除自定义域。

　　您的DNS设置最多可能需要24小时才能生效，并且在此期间您可能会收到一条错误消息。要查看状态，您可以访问此网站。

　　对DNS问题进行故障排除

　　如果您收到错误消息

　　RRSet of type CNAME with DNS name is not permitted as it conflicts with other records with the same DNS name in zone

　　添加第一个域时，请注意，CNAME记录不能与该域的任何其他记录共存。您将需要将您的子域的现有记录类型编辑为CNAME或添加一个新的子域。

　　如果在添加第二个域时收到相同的消息，请注意，由于TXT记录会验证该域的所有权，因此该值应与已为根域添加的令牌相同。将CNAME记录添加到与您的公共文档关联的URL，其值应为phs.getpostman.com。

　　在您的自定义域上发布收藏集

　　验证您的域后，您可以使用它来发布您的API文档。如果您已经发布了一个收藏集，则可以对其进行编辑以使用新域。

　　添加模板

　　要添加到共享的Postman模板中，您首先需要记录并发布一个收藏集。您可以在文档发布过程中或以后将您的收藏集共享到Postman模板中。发布期间，启用“馆藏发现”并选择“添加到邮递员模板”。

　　如果您的收藏文档已经发布，则可以通过编辑已发布的文档使其可被发现。

　　您可以从Postman（选择集合并单击在Web中查看）或从Web仪表板（导航到Workspace >集合并单击已发布的集合标题）访问已发布的文档。

　　单击“允许集合发现”来设置要共享的文档。

　　选择添加到邮递员模板。

　　提供模板详细信息

　　输入模板列表的显示详细信息，包括模板名称，摘要和描述。您的描述将自动从您已添加到集合中的任何描述中拉出，并且应包括潜在用户需要知道是否尝试使用模板的信息。

　　选择模板的任何相关类别-用户将能够在Postman应用程序和Web上使用类别进行浏览。

　　设定您的个人资料

　　个人帐户将能够发布到个人配置文件，而团队中的帐户将发布到团队配置文件。

　　从团队发布的模板也将出现在该团队的API网络列表模板选项卡中。

　　要设置您的个人资料，请点击“公共个人资料设置”或导航至您的设置。单击启用公共配置文件以允许您的模板被发布。

　　您可以自定义个人资料的URL和名称，添加人们会在模板旁边看到的描述，以及添加指向社交媒体和网站的链接。您还可以通过帐户设置设置个人资料照片。

　　自定义您的个人资料URL将更改您的用户名，并且该更改将反映在您所有Postman元素（例如馆藏和文档）中。您还将使用新用户名登录Postman。

　　如果您选择禁用个人资料，则将无法发布任何新模板，并且以前发布的任何模板都将无法发布。

　　发布您的模板

　　完成发布设置后，点击发布收藏。您将看到模板列表和公开个人资料的确认。

　　您可以在Postman内部使用“新建” >“模板”并在网络上发现您的模板。

　　您的个人资料列表将在Postman和网络上都可用，列出所有已发布的模板。

　　单击模板标题将打开一个完整的文档，并带有“在邮递员中运行”按钮，人们可以用来导入该集合并尝试在Postman中进行请求。