"Serialization for the format "html加载 API 文档时“不支持”

Question

我创建了一个新的 Symfony 5.3 项目并安装了 API-Platform。当我在 /api 加载 API 文档时，出现错误：

Symfony\Component\Serializer\Exception\NotEncodableValueException : Serialization for the format "html" is not supported.

我尝试将 html 格式添加到 api_platform.yml 配置文件：

api_platform:
    mapping:
        paths: ['%kernel.project_dir%/src/Entity']
    patch_formats:
        json: ['application/merge-patch+json']
    formats:
        json:   ['application/json']
        html: ['text/html']
    swagger:
        versions: [3]

我不知道如何访问 API 文档。

Answer 1

你有启用 twig 包吗

// config/bundles.php
Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],

也许您没有在

中启用文档生成

// config/packages/api_platform.yaml
  enable_swagger: true
  enable_swagger_ui: true
  enable_re_doc: true
  enable_entrypoint: true
  enable_docs: true

这解决了我的问题

"Serialization for the format "html加载 API 文档时“不支持”

"Serialization for the format "html" is not supported" when loading the API doc

symfony

api-platform.com

symfony5