Modulo "API (interfaccia)"
Prenoti appuntamenti direttamente dalla Sua applicazione.
Con l'API REST il Suo sito web, il Suo portale clienti, la Sua app o il Suo sistema CRM richiedono gli appuntamenti liberi e creano prenotazioni. I Suoi clienti restano così nell'ambiente a loro familiare e non devono aprire l'agenda.
I Suoi vantaggi in sintesi
- Il Suo design, il Suo processo: Il percorso di prenotazione ha esattamente l'aspetto che desidera.
- Tutto in un unico posto: Gli appuntamenti arrivano subito nell'agenda, comprese le consuete e-mail di notifica.
- Realizzato rapidamente: Sei chiamate in formato JSON coprono l'intero processo di prenotazione.
- Collegamento sicuro: L'accesso avviene tramite token, che genera Lei stesso e può rinnovare in qualsiasi momento.
Esempi di utilizzo
Percorso di prenotazione personalizzato
La prenotazione appuntamenti si integra perfettamente nel design del Suo sito web.
App mobile
I Suoi clienti prenotano gli appuntamenti direttamente nella Sua app.
CRM e software gestionale
Gli appuntamenti vengono creati direttamente dall'applicazione con cui lavora ogni giorno.
Shop e portale clienti
L'appuntamento viene assegnato direttamente nel processo d'ordine o nell'area riservata ai membri.
Assistente telefonico con IA
Un assistente vocale risponde alle chiamate, indica gli appuntamenti liberi e li prenota durante la conversazione tramite l'API.
Come si svolge una prenotazione
1. Calendario
La Sua applicazione richiede i calendari appuntamenti disponibili e seleziona quello adatto.
2. Motivo appuntamento
Per ogni calendario l'API fornisce le prestazioni con descrizione e durata.
3. Giorno
Vengono restituiti solo i giorni in cui è effettivamente libero un appuntamento.
4. Orario
Per il giorno selezionato riceve tutti gli orari appuntamenti liberi.
5. Campi del modulo
Quali dati richiedere ai Suoi clienti lo stabilisce nell'agenda. L'API indica i campi corrispondenti.
6. Prenotazione
L'appuntamento viene prenotato e vengono creati il record del cliente e l'appuntamento.
Gli appuntamenti prenotati tramite l'API compaiono immediatamente nell'agenda e attivano le consuete e-mail di notifica.
Esempio: prenotare un appuntamento
Richiesta
POST /api/bookings
Authorization: Bearer apm_il-suo-token
Content-Type: application/json
{
"schedule": 1,
"reason": 1,
"slot": "2026-05-23 09:00:00",
"submission": {
"first_name": "Hans",
"last_name": "Pitt",
"email": "hans.pitt@example.com"
}
}
Risposta
{
"booking_id": 142,
"booking_details_id": "a3f8c2d1e5b6",
"user_id": 87,
"slot": "2026-05-23T09:00:00Z"
}
Sicurezza e funzionamento
-
Accesso tramite tokenIl token lo genera Lei stesso nell'area di amministrazione sotto Configurazione → API.
-
Visibile una sola voltaIl token viene visualizzato una sola volta e nel sistema viene salvato esclusivamente come hash.
-
Rinnovabile in qualsiasi momentoSe genera un nuovo token, quello precedente perde immediatamente la sua validità.
-
300 richieste al minutoMargine sufficiente per il funzionamento corrente della Sua applicazione.
Maggiori informazioni
Guida
Passo dopo passo dall'attivazione al token fino alla prima prenotazione, con esempi per ogni chiamata.
Riferimento
Tutte le chiamate con parametri, codici di stato e schemi, oltre alla descrizione come file OpenAPI.
Webhooks
La direzione opposta: inviare automaticamente a un'applicazione esterna gli appuntamenti nuovi, cancellati e spostati.
Che cos'è un'API?
Una breve spiegazione dell'interfaccia di programmazione e delle sue possibilità nel glossario.
Pronti per più fatturato e meno lavoro?
Scegliete Appointmind per crescere e avere successo.
Visualizza altri moduli.