File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -432,9 +432,36 @@ The `list` action endpoint now supports advanced query parameters:
432432
433433---
434434
435- ### 📝 OpenAPI Path Example
435+ ### 📝 OpenAPI Documentation (Swagger)
436436
437- For ` /index.php?action=list&table={table} ` :
437+ ** Your API automatically generates OpenAPI 3.0 documentation!**
438+
439+ #### Get the OpenAPI Specification (JSON)
440+
441+ ``` bash
442+ # Access the auto-generated OpenAPI spec
443+ curl http://localhost:8000/index.php? action=openapi
444+
445+ # Or visit in browser:
446+ http://localhost:8000/index.php? action=openapi
447+ ```
448+
449+ #### View Interactive Documentation (Swagger UI)
450+
451+ ** Option 1: Online Swagger Editor** (Quick & Easy)
452+ 1 . Copy JSON from: ` http://localhost:8000/index.php?action=openapi `
453+ 2 . Paste into: https://editor.swagger.io/
454+ 3 . See beautiful interactive documentation!
455+
456+ ** Option 2: Use dashboard.html** (Recommended)
457+ Your project includes ` dashboard.html ` which has API documentation built-in:
458+ ```
459+ http://localhost:8000/dashboard.html
460+ ```
461+
462+ #### Example OpenAPI Path Structure
463+
464+ This is what the specification includes for ` /index.php?action=list&table={table} ` :
438465
439466``` yaml
440467get :
486513 pages : { type: integer }
487514` ` `
488515
516+ **Note:** The YAML above is just an example of the structure. The actual API returns JSON format.
517+
489518## 🛡️ Security Notes
490519
491520- **Enable authentication for any public deployment!**
You can’t perform that action at this time.
0 commit comments