在 openapi_context (Swagger) - api-platform 中用自定义参数替换“id”参数

如何解决在 openapi_context (Swagger) - api-platform 中用自定义参数替换“id”参数

我有一个实体的自定义操作，它使用 PUT 方法，我想在我的 swagger (OpenApi) 文档中记录参数。

这是定义

/*
 * itemOperations={
 *                  "get",*                  "patch",*                  "put",*                  "delete",*                  "activate"={
 *                      "method"="PUT",*                      "path"="/user/{token}/activate",*                      "requirements"={"token"="^\w{32}$"},*                      "controller"=ActivateUser::class,*                      "normalization_context"={"groups"={"user:read"}},*                      "denormalization_context"={"groups"={"user:activation"}},*                      "read"=false,*                      "validation_groups"={"Activate"},*                      "openapi_context"={
 *                          "summary"="Attiva un utente tramite token dopo la registrazione.",*                          "description"="Cambia lo stato dell'utente in 'attivo' permettendo così il login.",*                          "parameters"={
 *                              {
 *                                "in"="path",*                                "name"="token",*                                "required"=true,*                                "type"="string",*                                "description"="Il token generato al momento della registrazione."
 *                              }
 *                          }
 *                      }
 *                  },*              },*/

感兴趣的部分是 "openapi_context" 键，然后是 "parameters"。此描述不会更改有关参数定义的任何内容，ID 要求仍然存在并且没有令牌描述（我阅读了文档 here for path parameters in open api context

我错在哪里？有办法吗？