symfony - API 平台 - 如何记录身份验证路由

Question

我在 Symfony 4 Flex 应用程序中使用 API Platform v2.2.5，该应用程序由一个功能 API 和 JWT Authentication 组成。 ，一些资源默认Open API/Swagger documentation可通过 /api 路由访问的页面。每个 API 资源都通过平台配置自动包含在文档中，按照 library docs 。

如何为自定义操作(例如安全组件的身份验证路由)生成文档？ API Platform Documentation似乎不包含这些说明。

Answer 1

感谢this comment in a Github issue，我找到了答案。由于我使用 YAML 进行资源配置，因此我必须翻译 auth/login 端点的示例；

App\Entity\User:
  collectionOperations:
  auth:
    route_name: auth
    swagger_context:
      parameters:
        -
          name: username
          required: true
          type: string
          description: "User's username or email address"

        -
          name: password
          required: true
          type: string
          description: "User's password"

      responses:
        200:
          description: "Successful login attempt, returning a new token"
          schema:
            type: object
            required:
              - username
              - password
            properties:
              username:
                type: string

              password:
                type: string

      summary: Performs a login attempt, returning a valid token on success
      consumes:
        - "application/json"
        - "application/ld-json"
      produces:
        - "application/ld-json"