Endpoint: Utenti, Tenant e Quote
Riferimento sintetico degli endpoint di amministrazione: utenti, ruoli e permessi, tenant, piani e abbonamenti, API key, feature flag, quote e audit.
A differenza degli endpoint applicativi descritti nelle altre pagine di questa reference, la maggior parte di queste operazioni richiede un ruolo amministrativo (amministratore o Super Admin) e sono tipicamente consumate dalla console di Askme AI stessa. Il presente riferimento elenca gli endpoint disponibili con una descrizione sintetica; parametri di dettaglio ed esempi di richiesta/risposta saranno aggiunti in un aggiornamento successivo.
1. Utenti
| Endpoint | Metodo | Descrizione |
|---|---|---|
/users | GET, POST, PUT, DELETE | Gestione degli utenti del tenant. |
/users/me | GET | Profilo dell'utente autenticato dalla richiesta corrente. |
/users/me/preferences | GET, PATCH | Preferenze personali dell'utente autenticato. |
/users/{id}/roles | GET, POST | Ruoli assegnati a un utente. |
2. Ruoli e permessi
| Endpoint | Metodo | Descrizione |
|---|---|---|
/roles | GET, POST, PUT, DELETE | Gestione dei ruoli del tenant. |
/roles/{id}/permissions | GET, PUT | Permessi associati a un ruolo. |
/roles/{id}/feature-flags | GET, PUT | Feature flag associati a un ruolo. |
/permissions | GET | Elenco dei permessi disponibili nella piattaforma. |
3. Tenant
Le operazioni di provisioning e gestione tenant richiedono il ruolo Super Admin (amministratore di piattaforma) e non sono pensate per l'uso da parte di integrazioni esterne del tenant.
| Endpoint | Metodo | Descrizione |
|---|---|---|
/tenants | GET, POST, PUT, DELETE | Gestione dei tenant. |
/tenants/validate-license | POST | Validazione di una licenza. |
/tenants/create-free-license | POST | Creazione di una licenza gratuita. |
/tenants/{id}/suspend | POST | Sospende il tenant. |
/tenants/{id}/reactivate | POST | Riattiva il tenant. |
/tenants/{id}/restore | POST | Ripristina un tenant precedentemente rimosso. |
/tenants/{id}/refresh-license | POST | Forza il refresh della licenza dal servizio di licensing. |
/tenants/{id}/retention-policy | GET, PUT | Politica di conservazione dei dati del tenant. |
/tenants/{id}/plan | GET | Piano associato al tenant. |
/tenants/{id}/quotas | GET | Quote configurate per il tenant. |
4. Piani e abbonamenti
| Endpoint | Metodo | Descrizione |
|---|---|---|
/plans | GET | Elenco dei piani disponibili. |
/subscriptions/current | GET | Abbonamento corrente del tenant. |
/subscriptions | POST | Attivazione di un nuovo abbonamento. |
/subscriptions/{id}/cancel | POST | Annullamento di un abbonamento. |
5. API key
| Endpoint | Metodo | Descrizione |
|---|---|---|
/api-keys | GET, POST, DELETE | Gestione delle API key del tenant (generazione descritta in Autenticazione). |
/api-keys/{id}/rotate | POST | Rotazione di una API key esistente. |
/api-keys/validate | POST | Validazione di una API key (uso interno, service-to-service). |
6. Feature flag
| Endpoint | Metodo | Descrizione |
|---|---|---|
/feature-flags | GET | Elenco dei feature flag e del loro stato per il tenant. |
/feature-flags/{code}/override | PUT, DELETE | Override di un feature flag per il tenant. |
/feature-flags/{code}/check | GET | Verifica lo stato effettivo di un feature flag. |
7. Quote
| Endpoint | Metodo | Descrizione |
|---|---|---|
/quotas/usage | GET | Utilizzo corrente delle quote del tenant. |
/quotas/definitions | GET | Definizioni delle quote disponibili per piano. |
/quotas/overrides | POST, DELETE | Override manuale di una quota per il tenant. |
8. Alert quota
| Endpoint | Metodo | Descrizione |
|---|---|---|
/quota-alerts/settings | GET, PUT | Configurazione delle soglie di allarme quota. |
/quota-alerts/templates/{id} | GET, PUT | Template dei messaggi di allarme quota. |
9. Audit
| Endpoint | Metodo | Descrizione |
|---|---|---|
/audit/events | GET | Elenco degli eventi di audit del tenant. |
/audit/events/export | GET | Esportazione degli eventi di audit. |