Il Suo strumento legge l’agenda, e ogni appuntamento gli arriva firmato.

Lei legge tre cose di un’attività, e ciascuna è garantita

Sotto /api/v1/public, Lei legge l’identità dell’attività, il suo catalogo attivo e gli orari liberi di una giornata; qualsiasi altro indirizzo risponde 404, con l’elenco delle tre rotte.

Ogni campo ricevuto è garantito: il nostro modello interno può cambiare, la Sua lettura non cambia; un prezzo che si stabilisce sul posto si dice «su richiesta», mai 0.

• Ogni rispostala sua versione di contratto, l’identificativo dell’attività, l’intestazione X-Api-Version
• Ogni erroreun code stabile da verificare, un messaggio leggibile
• Cache-Control: private, no-storesu ogni risposta, rifiuto per limite di frequenza compreso

Lei legge l’ora dell’attività, e «chiuso» si distingue da «completo»

«14:30» sono le 14.30 sul posto: ogni ora è espressa nel fuso dell’attività, che la rotta salon Le dà.

I Suoi orari liberi seguono le regole dell’attività: orari del team, ferie, chiusure; una prestazione che richiede prima una visita non restituisce alcuna disponibilità. Due indicatori dicono perché una giornata è vuota.

La Sua chiave apre un’attività, in lettura, e nient’altro

Gliela consegniamo con un’etichetta e il Suo indirizzo di contatto tecnico; viene mostrata una sola volta, noi ne conserviamo solo l’impronta. Due strumenti, due chiavi.

I Suoi dati vengono dalla Sua chiave, mai dall’indirizzo chiamato: la Sua chiave legge soltanto i Suoi dati, sul Suo dominio come sul Suo indirizzo Co-Labs. Un token interno qui non apre nulla.

• Formaclk_ seguito da 32 byte estratti a caso
• IntestazioneAuthorization: Bearer oppure X-API-Key
• Perimetrouno solo, public:read: nessuna scrittura in v1
• Frequenza120 richieste al minuto, contate per chiave

Ogni appuntamento Le arriva, firmato

Creato, annullato o spostato — sul sito, con Liah al telefono o per iscritto, al bancone — l’appuntamento Le viene annunciato con un POST firmato, canale d’ingresso compreso; un test del nostro codice verifica che ogni percorso che scrive un appuntamento lo annunci.

Ogni consegna porta Colabs-Signature: t=<marca temporale>,v1=<HMAC-SHA256>, calcolata sulla marca temporale e sul corpo così come parte. La verifichi a tempo costante, in una finestra di cinque minuti; Colabs-Event-Id e Colabs-Attempt Le permettono di deduplicare un nuovo tentativo.

• Eventirdv.cree, rdv.annule, rdv.deplace, e non uno di più
• Segretouno per abbonamento, mostrato una volta, cifrato a riposo
• Carico utileun riferimento opaco, data, ora, durata, prestazione, stato, canale
• Nessun dato personalené nome, né telefono, né e-mail, né nota
• Prova a vuotoun webhook.test dalla nostra console

Il Suo server può andare giù: l’evento La aspetta

Nulla parte durante la prenotazione della cliente: l’evento è custodito da noi e poi portato fino a Lei, e la prenotazione va a buon fine anche se il Suo server è in manutenzione. Sette tentativi su circa 8 ore e 45 minuti: un appuntamento del mattino seguente arriva in tempo.

Una risposta 2xx vale come successo; tutto il resto è un fallimento, reindirizzamento compreso. Dopo cinque consegne fallite di fila, l’abbonamento si mette in pausa; lo riattiviamo insieme a Lei, con il contatore azzerato.

• Tentativiimmediato, poi 10 s, 1 min, 5 min, 30 min, 2 h, 6 h
• Scadenza10 secondi per consegna
• Il Suo indirizzoHTTPS obbligatorio, indirizzi privati rifiutati, nessun reindirizzamento seguito
• Memoriauna consegna conclusa si cancella dopo 30 giorni, mai una consegna in attesa

La Sua integrazione regge nel tempo

La versione vive nel percorso, v1, e la revisione del contratto in ogni risposta. Un campo, una rotta o un valore possono aggiungersi: preveda un caso predefinito. Nulla di esistente sparisce né cambia significato — sarebbe una v2, e il nostro contratto scritto mantiene allora la v1 per almeno dodici mesi, con le intestazioni Deprecation e Sunset.

L’indirizzo di contatto lasciato alla consegna della chiave è obbligatorio: è da lì che La avvisiamo.