1.1 Endpoint REST
Panoramica di tutti gli endpoint REST1) disponibili.
Architettura
L'API segue i principi REST2) e usa metodi HTTP3) per operazioni CRUD.
Tabelle
| Metodo | Route | Descrizione |
| GET | /tables | Lista di tutte le tabelle |
| GET | /tables/{name} | Leggere dati |
| POST | /tables/{name} | Inserire record |
| PUT | /tables/{name} | Aggiornare record |
| DELETE | /tables/{name} | Eliminare record |
| PATCH | /tables/{name} | Modifiche batch |
Viste
| Metodo | Route | Descrizione |
| GET | /views | Lista di tutte le viste |
| GET | /views/{name} | Leggere dati vista |
Stored Procedures
| Metodo | Route | Descrizione |
| GET | /procedures | Lista di tutte le procedure |
| POST | /procedures/{name}/execute | Eseguire procedura |
Query Ad-Hoc
| Metodo | Route | Descrizione |
| POST | /query | Eseguire query SQL |
Codici di Stato HTTP
L'API usa codici di stato HTTP standard4):
| Codice | Significato | Utilizzo |
| 200 | OK | GET/PUT/PATCH riuscito |
| 201 | Created | POST riuscito |
| 204 | No Content | DELETE riuscito |
| 400 | Bad Request | Richiesta non valida |
| 401 | Unauthorized | Autenticazione richiesta |
| 403 | Forbidden | Nessuna autorizzazione |
| 404 | Not Found | Risorsa non trovata |
| 500 | Server Error | Errore interno |
Approfondimenti
Fonti