Richieste di preventivo tramite agenti AI

Gli assistenti AI possono inviare richieste per gruppi da 4 a 30 persone tramite POST /api/preventivi sul dominio di questo sito, senza autenticazione.

Invia solo su richiesta dell’utente, usando i suoi dati e un recapito email reale. Raccogli i campi obbligatori prima dell’invio. Una richiesta di preventivo non conferma disponibilità, prezzo o prenotazione.

Specifica OpenAPI 3.1 (JSON) · Istruzioni testuali per agenti (English)

Dati richiesti

Obbligatori: nome, cognome, email, persone (intero 4–30), partenza, destinazione, data (AAAA-MM-GG, non nel passato).

Facoltativi: telefono, ora (HH:mm, fuso Europe/Rome) e note. I nomi dei campi restano in italiano anche per richieste in inglese. Il corpo massimo è 16 KiB.

Esempio di corpo JSON

Usa Content-Type: application/json. Sostituisci i dati di esempio con quelli dell’utente, inclusa una data futura.

{
  "nome": "Mario",
  "cognome": "Rossi",
  "email": "mario.rossi@example.com",
  "persone": 8,
  "partenza": "Cortina d’Ampezzo",
  "destinazione": "Aeroporto di Venezia",
  "data": "2027-12-20",
  "ora": "09:30",
  "note": "Otto valigie"
}

Esito e gestione degli errori

Solo HTTP 201 con status: submitted indica che il servizio destinatario ha accettato la richiesta. Conserva il requestId e comunicalo all’utente.

• 400: corpo non valido; 413: corpo troppo grande; 415: formato non supportato.
• 422: correggi gli errori nei campi indicati in fields prima di inviare nuovamente.
• 503: servizio di invio non disponibile. La richiesta non è stata inoltrata.
• 502 o errore di rete: consegna incerta. Non riprovare automaticamente, per evitare duplicati; verifica con Taxi Cortina Dolomiti.

Non vengono addebitati importi e non viene effettuata alcuna prenotazione automatica.