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.
Leggi la DocumentazioneUna 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
Per Iniziare
Inizia a sviluppare con il nostro SDK o REST API in pochi minuti. Documentazione completa ed esempi interattivi su developers.yappointment.com.
Visualizza la Documentazioneimport { 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 la differenza?
14 giorni. Accesso completo. Senza carta di credito. Niente 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