Hub per Sviluppatori e API Pubblica
Tutto ciò di cui gli sviluppatori hanno bisogno per integrare yAppointment nei propri prodotti — una REST API pubblica, OAuth 2.1 per l'accesso delegato dagli utenti, webhook firmati e un TypeScript SDK pronto all'uso.
Read the DocsUna Piattaforma Completa per Sviluppatori
Componenti pronti per la produzione per connettere yAppointment alle tue app, flussi di lavoro e integrazioni
REST API Pubblica
Una REST API chiara e prevedibile su /api/v1 per leggere e scrivere i dati della tua azienda, prenotazioni e clienti — con chiavi di idempotenza per evitare doppie prenotazioni nei retry.
- Lettura e scrittura di dati aziendali, prenotazioni e clienti
- Creazione di prenotazioni idempotente con chiavi di idempotenza
- Gestione degli endpoint webhook in modo programmatico
- Prezzi restituiti in unità minori (centesimi) per calcoli precisi
- Risposte JSON coerenti e ben strutturate
OAuth 2.1 + PKCE
Consenti ai tuoi utenti di collegare il proprio account yAppointment alla tua app in modo sicuro tramite il flusso Authorization-Code e PKCE — nessuna condivisione di password, solo accesso con scope definiti.
- Flusso Authorization-Code con PKCE per un accesso utente delegato sicuro
- Scope granulari: read/write:bookings e read/write:customers
- Accesso al profilo e alle analisi tramite read:profile e read:analytics
- Gestione dei webhook tramite lo scope webhooks:manage
- Gli utenti concedono l'accesso senza mai condividere le credenziali
Chiavi API Server e Pubbliche
Emetti chiavi server (yapp_sk_*) per le integrazioni backend e chiavi pubbliche (yapp_pk_*) per l'uso lato client, con ambienti live e di test completamente separati.
- Chiavi server (yapp_sk_*) per chiamate server-to-server affidabili
- Chiavi pubbliche (yapp_pk_*) per un utilizzo sicuro lato client
- Ambienti live e di test separati per sviluppare in tutta tranquillità
- Ruota le chiavi in qualsiasi momento dalla tua dashboard
- Testa con dati sandbox prima di andare in produzione
Webhook Firmati
Ricevi una notifica non appena qualcosa cambia. yAppointment consegna 9 tipi di eventi ai tuoi endpoint HTTPS con retry automatici e tracciamento completo delle consegne.
- 9 tipi di eventi che coprono prenotazioni, clienti, servizi e dipendenti
- Eventi booking.created, booking.updated e booking.cancelled
- Endpoint solo HTTPS con un segreto di firma whsec_
- Firme HMAC-SHA256 nell'header yapp-signature
- Retry automatici con tracciamento delle consegne, più consegne di test dalla dashboard
Getting Started
Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.
View Documentationimport { YAppointmentClient } from
'@lohisoftsro/yappointment-sdk';
const client = new YAppointmentClient({
apiKey: process.env.API_KEY,
baseUrl: 'https://api.yappointment.com'
});
// Create a booking
const booking = await client.bookings.create({
serviceId: 'srv_123',
customerId: 'cst_456',
startTime: '2025-07-01T10:00:00Z',
idempotencyKey: 'req_xyz789'
});
console.log('Booked:', booking.id);Pensato per una Grande Esperienza di Sviluppo
Gli strumenti e la documentazione che rendono l'integrazione di yAppointment rapida e piacevole
TypeScript SDK
Evita il codice ripetitivo con il nostro TypeScript SDK ufficiale su npm — @lohisoftsro/yappointment-sdk — generato direttamente dalla nostra specifica OpenAPI, con supporto ESM e CJS.
Documentazione Interattiva per Sviluppatori
Esplora ogni endpoint su developers.yappointment.com con un riferimento API Scalar interattivo che puoi leggere, cercare e provare mentre costruisci.
Modalità Live e di Test
Chiavi API live e di test separate ti permettono di sviluppare e sperimentare in sicurezza, poi di passare alla produzione quando sei pronto — senza toccare dati reali.
Retry Sicuri
Le chiavi di idempotenza rendono sicuro il retry della creazione di prenotazioni, così i problemi di rete non si trasformano mai in appuntamenti duplicati.
Pronto a vedere cosa cambia?
14 giorni. Accesso completo. Senza carta di credito. Cosa hai da perdere?
Imprenditori in tutta Europa hanno sostituito il caos amministrativo con un'unica piattaforma che funziona davvero. Unisciti a loro oggi.
14 giorni di prova gratuita • Senza commissioni — sempre • Disdici quando vuoi