Skip to content

Commit 322c169

Browse files
committed
up
1 parent 262a419 commit 322c169

1 file changed

Lines changed: 31 additions & 2 deletions

File tree

README.md

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff 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
440467
get:
@@ -486,6 +513,8 @@ get:
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!**

0 commit comments

Comments
 (0)