Chirona API
Scarica sitemap

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"] } }
StatoCodiceSignificato
400validation_error, invalid_requestDati mancanti o non validi
401unauthorized, invalid_credentialsToken assente, non valido o sessione scaduta; credenziali errate
403forbiddenOperazione non consentita al tuo ruolo
404not_foundRisorsa inesistente o non visibile
409conflict, slot_unavailable, …Conflitto con lo stato attuale (duplicato, orario occupato, …)
422invalid_reference, …Riferimento a un dato inesistente o non utilizzabile
429too_many_attemptsTroppi 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.