Feny2026-08-18 - baseline v1
- Aggiunte letture con ambito per catalogo, specialisti e disponibilità.
- Aggiunta la creazione idempotente di prenotazioni ospite con riferimenti pbr_ opachi.
- Documentata la prenotazione v1 a servizio singolo; quella composta resta disponibile nel widget firmato e nel flusso proprietario.
- Aggiunta la gestione versionata di annullamento e riprogrammazione secondo le regole dell’attività.
- Aggiunte consegna webhook firmata, prove dei tentativi, controlli pausa/replay e convalida rigorosa della destinazione.
Politica di compatibilità
Rotte v1 stabili
I campi e i codici errore v1 esistenti non cambiano significato senza avviso.
Modifiche additive
Possono apparire nuovi campi di risposta facoltativi. I consumer devono ignorare i campi sconosciuti.
Modifiche incompatibili
Prima di rimuovere un comportamento servono una nuova versione o un percorso di deprecazione documentato.
Politica di deprecazione
- Una modifica incompatibile viene rilasciata su una nuova rotta versionata o annunciata pubblicamente indicando rotta o campo, migrazione e data di ritiro.
- La data di ritiro e l’eventuale supporto sono pubblicati con la deprecazione. Questa documentazione non inventa un periodo fisso o SLA.
- Usa l’ultima versione documentata, ignora campi additivi sconosciuti e controlla il changelog prima di modificare un’integrazione production.