API · Appuntamenti e prenotazioni

Collega la tua agenda a SellViaApp

Gestisci servizi, risorse, orari, indisponibilità, fasce e prenotazioni dal tuo software.

Avvio rapido

Autentica, scegli un percorso, prova.

Recupera l’X-API-Key e genera il token Bearer in Dashboard → API. Inseriscili qui sotto. Poi scegli «Testa · Genera» su un endpoint per vedere la risposta e il codice di esempio in cURL, PHP 8 o JavaScript.

Credenti incompletiImmettere il token X-API-Key e Bearer per preparare un test.

Le credenziali rimangono in memoria solo per questa pagina. Per un'operazione legata al cliente, aggiungere customer_id.

Keep in mindHTTPS + JSON · mantenere entrambe le credenziali lato server · non inviare mai gettoni per supportare.

Punti di fine

Appuntamenti e prenotazioni

Configurare servizi, risorse, orari e prenotazioni dall'app mobile, un ERP o un software aziendale.

33 routes
GET /booking/config/get Chiave + Cuscinetto

Leggi le regole di prenotazione e la valuta dell'app.

PATCH /booking/config/update Chiave + Cuscinetto

Norme di aggiornamento, cancellazione e promemoria. La conferma a due passi rimane sempre attiva.

GET /booking/service-category/list Chiave + Cuscinetto

Elenca categorie di servizi e sottocategorie.

POST /booking/service-category/add Chiave + Cuscinetto

Creare una categoria principale o sottocategoria.

PATCH /booking/service-category/update Chiave + Cuscinetto

Aggiorna una classificazione della categoria di servizio.

DELETE /booking/service-category/delete Chiave + Cuscinetto

Eliminare una categoria inutilizzata o archiviarla.

GET /booking/service/list Chiave + Cuscinetto

Elenca i servizi prenotabili e le risorse ammissibili.

GET /booking/service/detail Chiave + Cuscinetto

Recuperare un servizio descrizione dettagliata e galleria fotografica.

POST /booking/service/add Chiave + Cuscinetto

Crea un servizio con durata, prezzo e risorse.

POST /booking/service/photo/add Chiave + Cuscinetto

Aggiungi una foto a una galleria di servizio.

DELETE /booking/service/photo/delete Chiave + Cuscinetto

Eliminare una foto di servizio.

PATCH /booking/service/photo/primary Chiave + Cuscinetto

Selezionare la foto principale mostrata nell'elenco mobile.

PATCH /booking/service/update Chiave + Cuscinetto

Aggiorna un servizio prenotabile.

DELETE /booking/service/delete Chiave + Cuscinetto

Eliminare un servizio inutilizzato o archiviarlo.

GET /booking/resource/list Chiave + Cuscinetto

Elenca persone, camere, veicoli, attrezzature e risorse di capacità.

POST /booking/resource/add Chiave + Cuscinetto

Creare una risorsa prenotabile.

PATCH /booking/resource/update Chiave + Cuscinetto

Aggiorna una risorsa.

DELETE /booking/resource/delete Chiave + Cuscinetto

Eliminare una risorsa non utilizzata o archiviarla.

GET /booking/availability/list Chiave + Cuscinetto

Elenca gli orari settimanali.

POST /booking/availability/add Chiave + Cuscinetto

Aggiungi un programma generale, specifico per il servizio o specifico per le risorse.

DELETE /booking/availability/delete Chiave + Cuscinetto

Cancella un programma.

GET /booking/unavailability/list Chiave + Cuscinetto

Elenca vacanze, chiusure e periodi bloccati.

POST /booking/unavailability/add Chiave + Cuscinetto

Bloccare un periodo generale o specifico per le risorse.

DELETE /booking/unavailability/delete Chiave + Cuscinetto

Eliminare una indisponibilità.

GET /booking/slot/list Chiave + Cuscinetto

Elenca le slot disponibili e le slot temporaneamente in attesa di conferma dell'amministratore.

GET /booking/list Chiave + Cuscinetto

Elenco prenotazioni autorizzate.

GET /booking/detail Chiave + Cuscinetto

Recuperare una prenotazione e la sua storia.

POST /booking/create Chiave + Cuscinetto

Creare e confermare la richiesta del cliente; l'approvazione dell'amministratore è quindi ancora richiesta.

POST /booking/customer-confirm Chiave + Cuscinetto

Confermare una prenotazione sul lato cliente.

POST /booking/admin-confirm Chiave + Cuscinetto

Confermare, tornare in attesa o rifiutare la prenotazione da parte dell'amministratore.

PATCH /booking/update Chiave + Cuscinetto

Reschedule o aggiornare una prenotazione.

PATCH /booking/status/update Chiave + Cuscinetto

Avanzare una prenotazione che è già stata confermata da entrambe le parti.

POST /booking/cancel Chiave + Cuscinetto

Cancellare secondo la scadenza configurata.

Punti di fine

Pagamenti dei clienti

Scegliere il pagamento alla consegna o aprire un pagamento sicuro Stripe, quindi recuperare lo stato server-verified.

4 routes
GET /payment/config Chiave + Cuscinetto

Recuperare i metodi di pagamento Stripe abilitati e il fornitore di account Stripe selezionato per l'app.

POST /payment/checkout/create Chiave + Cuscinetto

Crea o riprendi una pagina Stripe Checkout per un ordine o una prenotazione non pagati del cliente autenticato. Se ancora modificabile, la scelta di pagare alla consegna viene sostituita in modo sicuro.

POST /payment/pay-later Chiave + Cuscinetto

Registrare il pagamento alla consegna o sostituire un pagamento Stripe ancora aperto dopo la sua sessione è controllato e scaduto in modo sicuro.

GET /payment/status Chiave + Cuscinetto

Recuperare uno stato di pagamento; solo il webhook firmato Stripe può confermare come pagato.

Reference

Risposte ed errori

In «Parametri e risposte» trovi i campi obbligatori e facoltativi, i codici di stato e gli esempi JSON. Un elenco vuoto indica solo che non ci sono ancora dati. Non significa che l’endpoint non funzioni.

400Richiesta non valida
401Autenticazione richiesta
403Accesso negato
404Risorse o percorso non trovato
409conflitto commerciale
422Mancato il mancato convalida
429Troppe richieste
5xxxxIncidenza tecnica

Area di lavoro API

Endpoint

GET

Il codice generato contiene le credenziali inserite. Conservale sul server e non condividere mai uno screenshot senza oscurarle.

Pronto per il test