Chirona API
API REST per la piattaforma Chirona: medici, pazienti, appuntamenti, ricette, certificati, chat, notifiche, richieste,
sottoscrizioni, pagamenti e campagne. Le risposte sono in JSON con i nomi dei campi in snake_case.
Autenticazione
Accedi con POST /auth/sign-in e invia il token in ogni chiamata con l'intestazione
Authorization: Bearer <token>. La sessione resta valida finché si usa l'API: dopo
30 minuti di inattività scade e occorre accedere di nuovo. Il token non cambia mai durante la sessione.
Postman
Premi Scarica Postman in alto e in Postman usa Import → File: ottieni tutte le chiamate,
già raggruppate, con la variabile baseUrl (l'indirizzo base scelto in alto). Esegui POST /auth/sign-in:
il token viene salvato da solo nella variabile token e usato dalle altre chiamate.
In alternativa copia il comando di una chiamata (scegli Linux (bash)) e usa Import → Raw text.
Ottieni il token
Errori
Gli errori hanno sempre questa forma e un codice HTTP coerente.
{ "error": { "code": "validation_error", "message": "Dati non validi", "details": ["email: campo obbligatorio"] } }
| Stato | Codice | Significato |
|---|---|---|
| 400 | validation_error, invalid_request | Dati mancanti o non validi |
| 401 | unauthorized, invalid_credentials | Token assente, non valido o sessione scaduta; credenziali errate |
| 403 | forbidden | Operazione non consentita al tuo ruolo |
| 404 | not_found | Risorsa inesistente o non visibile |
| 409 | conflict, slot_unavailable, … | Conflitto con lo stato attuale (duplicato, orario occupato, …) |
| 422 | invalid_reference, … | Riferimento a un dato inesistente o non utilizzabile |
| 429 | too_many_attempts | Troppi tentativi di accesso, riprovare più tardi |
Gli elenchi accettano limit (1-200, default 50) e offset. Le modifiche (PUT) sono parziali: si inviano solo i campi da cambiare.