fix: multiple formats for custom "api_doc" route example

api-platform · Jan 14, 2025 · 61bdb05 · 61bdb05
1 parent 7e03e77
commit 61bdb05
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/core/openapi.md b/core/openapi.md
@@ -512,8 +512,11 @@ Manually register the Swagger UI controller:
 ```yaml
 # app/config/routes.yaml
 api_doc:
-    path: /api_documentation
+    path: /api_documentation.{_format}
     controller: api_platform.swagger_ui.action
+    methods: ['HEAD', 'GET']
+    defaults:
+        _format: html
 ```
 
 Change `/api_documentation` to the URI you wish Swagger UI to be accessible on.