如果您在使用自定义控制器和操作时发现API平台的描述标注无法正常工作,则可能是您的操作或控制器没有被正确标记。要解决这个问题,您需要在控制器或操作的注释中包含正确的标记。
例如,如果您有一个自定义的操作,想要在API平台中显示它的描述,您需要在注释中包含以下标记:
/**
* @ApiDoc(
* description="My custom operation",
* ...
* )
*/
其中'...”代表其他属性,例如请求参数,响应模型等。通过包含这些标记,API平台才能正确解析您的注释并在文档中显示它们。
同样,如果您的自定义控制器没有正确的注释,API平台也无法正确解析它们。例如,如果您有一个自定义控制器,并且想要在文档中显示它,请确保在控制器注释中包含以下标记:
/**
* @ApiResource()
*/
这将确保API平台将您的控制器识别为资源,并在API文档中显示它。
总之,要确保API平台的自定义控制器和操作描述标注正常工作,您需要在相应的注释中包含正确的标记。