README

如果您使用API Platform 2.0或更高版本，则无需此包。 API Platform现在原生支持Swagger，Postman可以从Swagger文档创建集合。

基于Postman的集合生成器，基于API Platform。

安装

通过Composer安装此包

composer require --dev api-platform/postman-collection-generator

使用Symfony，更新您的AppKernel.php文件

public function registerBundles()
{
    ...
    if ($this->getEnvironment() != 'prod') {
        ...
        $bundles[] = new PostmanGeneratorBundle\PostmanGeneratorBundle();
    }
}

配置

此库需要一些配置。按以下方式编辑您的app/config_dev.yml文件

postman_generator:
    name: Name of your API                  # Required
    description: Description of your API    # Optional, default: null
    baseUrl: http://www.example.com         # Required
    public: false                           # Optional, default: false
    authentication: oauth2                  # Optional, default: null
    defaultLocale: fr_FR                    # Optional, default: en_GB

使用

此包提供了一个独特的命令，可以自动根据您的API Platform项目配置生成Postman集合。运行php app/console postman:collection:build --help以获取更多详细信息。

使用解析器

此库提供了一个简单的扩展方式，称为parsers。其中有2个：请求解析器 & 命令解析器。

请求解析器

请求解析器是在将请求发送到集合之前执行以编辑Postman请求的服务。例如，您可以添加自定义认证头，添加一些测试等。

要创建自己的请求解析器，您的服务必须实现PostmanGeneratorBundle\RequestParser\RequestParserInterface，并具有标签postman.request_parser。

注意：一些请求解析器可能会在您的解析器之前执行。请检查Symfony依赖注入中的priority过程。

命令解析器

命令解析器是执行以连接到主命令的服务，例如请求认证访问。

要创建自己的命令解析器，您的服务必须实现PostmanGeneratorBundle\CommandParser\CommandParserInterface，并具有标签postman.command_parser。`parse`方法允许您向用户提问，`execute`方法执行您的操作。

注意：一些命令解析器可能会在您的解析器之前执行。请检查Symfony依赖注入中的priority过程。

认证

默认情况下，此库可以管理OAuth2认证。要使用它，使用oauth2填充authentication配置键。当使用主命令时，您将提示输入一些登录名/密码。它们将在Postman中作为环境变量管理。

请随意添加您自己的认证器作为请求 & 命令解析器。