Files
overland-controller/docs/api-v1-audit.md

50 lines
4.8 KiB
Markdown

# API v1 Audit
Generated: 2026-06-09
This audit checks for legacy `/api/...` references that should use `/api/v1/...`.
Valid `/api/v1/...` references are intentionally ignored.
## Potential Legacy References
| File | Line | Matched legacy path | Content |
|------|------|---------------------|---------|
| `tests/test_http_api_contract.py` | 31 | `/api/v1{match.group` | (f"/api/v1{match.group(1)}", match.group(2) or "ANY") |
| `tests/test_http_api_contract.py` | 82 | `/api/v1` | assert 'const API_BASE="/api/v1";' in source |
| `docs/project-state.md` | 192 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/HARDWARE.md` | 148 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/ARCHITECTURE.md` | 200 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/API.md` | 14 | `/api/v1` | /api/v1 |
| `docs/API.md` | 60 | `/api/v1` | Pre-versioned root routes remain registered as compatibility aliases for existing local clients. New clients should use `/api/v1`. |
| `docs/API.md` | 837 | `/api/v1` | Current stable API prefix is `/api/v1`, for example `GET /api/v1/status`. |
| `docs/CHATGPT_HANDOFF.md` | 49 | `/api/v1` | - HTTP API base path is `/api/v1`. |
| `docs/CHATGPT_HANDOFF.md` | 67 | `/api/v1` | New clients should use `/api/v1`. |
| `docs/CHATGPT_HANDOFF.md` | 98 | `/api/v1` | - The project recently standardized current HTTP routes under `/api/v1`. |
| `docs/CHATGPT_HANDOFF.md` | 100 | `/api/v1` | - The embedded WebUI uses `const API_BASE="/api/v1";`. |
| `docs/CHATGPT_HANDOFF.md` | 136 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/api-v1-audit.md` | 5 | `/api/...` | This audit checks for legacy `/api/...` references that should likely use `/api/v1/...`. |
| `docs/api-v1-audit.md` | 11 | `/api/v1{match.group` | \| `tests/test_http_api_contract.py` \| 31 \| (f"/api/v1{match.group(1)}", match.group(2) or "ANY") \| |
| `docs/api-v1-audit.md` | 12 | `/api/v1` | \| `tests/test_http_api_contract.py` \| 82 \| assert 'const API_BASE="/api/v1";' in source \| |
| `docs/api-v1-audit.md` | 13 | `/api/v1` | \| `docs/project-state.md` \| 192 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 14 | `/api/v1` | \| `docs/HARDWARE.md` \| 148 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 15 | `/api/v1` | \| `docs/ARCHITECTURE.md` \| 200 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 16 | `/api/v1` | \| `docs/API.md` \| 14 \| /api/v1 \| |
| `docs/api-v1-audit.md` | 17 | `/api/v1` | \| `docs/API.md` \| 60 \| Pre-versioned root routes remain registered as compatibility aliases for existing local clients. New clients should use `/api/v1`. \| |
| `docs/api-v1-audit.md` | 18 | `/api/v1` | \| `docs/CHATGPT_HANDOFF.md` \| 49 \| - HTTP API base path is `/api/v1`. \| |
| `docs/api-v1-audit.md` | 19 | `/api/v1` | \| `docs/CHATGPT_HANDOFF.md` \| 67 \| New clients should use `/api/v1`. \| |
| `docs/api-v1-audit.md` | 20 | `/api/v1` | \| `docs/CHATGPT_HANDOFF.md` \| 98 \| - The project recently standardized current HTTP routes under `/api/v1`. \| |
| `docs/api-v1-audit.md` | 21 | `/api/v1` | \| `docs/CHATGPT_HANDOFF.md` \| 100 \| - The embedded WebUI uses `const API_BASE="/api/v1";`. \| |
| `docs/api-v1-audit.md` | 22 | `/api/v1` | \| `docs/CHATGPT_HANDOFF.md` \| 136 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 23 | `/api/v1` | \| `docs/dashboard-esp32s3.md` \| 161 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 24 | `/api/v1` | \| `docs/roadmap.md` \| 135 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 25 | `/api/v1` | \| `docs/UART_PROTOCOL.md` \| 281 \| Active dashboard communication is WiFi/HTTP using `/api/v1`. \| |
| `docs/api-v1-audit.md` | 26 | `/api/v1` | \| `firmware/esp32/overland-controller/overland-controller.ino` \| 664 \| const API_BASE="/api/v1"; \| |
| `docs/api-v1-audit.md` | 27 | `/api/v1` | \| `firmware/esp32/overland-controller/overland-controller.ino` \| 1342 \| #define API_V1(path) "/api/v1" path \| |
| `docs/dashboard-esp32s3.md` | 161 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/README.md` | 55 | `/api/v1` | - `api-v1-audit.md` - Audit of legacy API paths vs `/api/v1` namespace. |
| `docs/roadmap.md` | 135 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `docs/UART_PROTOCOL.md` | 281 | `/api/v1` | Active dashboard communication is WiFi/HTTP using `/api/v1`. |
| `firmware/esp32/overland-controller/overland-controller.ino` | 664 | `/api/v1` | const API_BASE="/api/v1"; |
| `firmware/esp32/overland-controller/overland-controller.ino` | 1342 | `/api/v1` | #define API_V1(path) "/api/v1" path |