API attività

Tour, attrazioni ed esperienze

Esplora un catalogo, verifica la disponibilità per data e fascia oraria, prenota e consegna un voucher. Un flusso REST, prezzi in USD.

GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Panoramica

Il contenuto delle attività è ampio e la disponibilità è sensibile al tempo. Questa API di attività offre un catalogo con ricerca, disponibilità per data e fascia con gli orari passati già filtrati, un flusso di prenotazione semplice e voucher scaricabili.

L'API di tour e attività racchiude un catalogo profondo di esperienze con disponibilità reale e sensibile al tempo. Categorie, lingue, durate, fasce di prezzo e inventario per fascia oraria sono unificati in un solo flusso, così vendi una visita a piedi o una gita con lo stesso codice che già usi per voli e hotel.

Cosa ottieni

1

Cerca nel catalogo per città, categoria, prezzo e lingua.

2

Leggi date e fasce prenotabili, già filtrate in base all'orario locale dell'attività.

3

Crea una prenotazione, confermala e scarica il voucher.

4

La disponibilità è filtrata rispetto all'ora locale di ogni attività, così le fasce passate non compaiono mai.

5

Voucher scaricabili e un evento di stato della prenotazione a cui iscriverti invece di fare polling.

Come funziona il flusso

01

Browse

Search the catalogue by city, category, price, or language.

02

Availability

Read bookable dates, then timeslots for a chosen date.

03

Book

Create a booking for a product-type and traveller mix.

04

Voucher

Confirm and download the voucher, or watch the status event.

Endpoint principali

GET/Activity/v2/productsSearch the activity catalogue.
GET/Activity/v2/availability/datesList bookable dates for a product.
GET/Activity/v2/availability/timeslotsList timeslots for a chosen date.
POST/Activity/v2/bookingsCreate a booking.
GET/Activity/v2/bookings/{id}/voucherDownload the voucher.

Richiesta e risposta

Request · GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Response · 200 OK
{
  "products": [
    {
      "productId": "ACT-4410",
      "title": "Old Town Walking Tour",
      "durationMinutes": 120,
      "from": { "amount": 29.00, "currency": "USD" },
      "productTypes": [
        { "code": "ADULT", "label": "Adult ticket" }
      ]
    }
  ]
}

Cosa include la risposta

productId
Stable id for the activity.
productTypes
Bookable variants, such as ticket tiers or packages.
from
Lead-in price, in USD.
durationMinutes
Length of the experience.
cancellationPolicy
Free-cancellation window, if any.
2.500+

Attività nelle destinazioni di tutto il mondo

Domande frequenti

Come viene restituita la disponibilità?

Come date prenotabili e come fasce per una data scelta. Ciò che è già passato viene rimosso in base all'orario locale dell'attività.

Cos'è un product-type?

Una variante prenotabile di un prodotto, come un livello di biglietto o un pacchetto. Prenoti tramite il suo id.

Quando ottengo il voucher?

Quando la prenotazione viene emessa. Puoi seguire l'evento di stato invece di fare polling.

Come funzionano i product-type?

Un product-type è una variante prenotabile, come un biglietto adulto o un pacchetto. Prenoti con il suo codice insieme alla composizione dei viaggiatori.

Posso avere lo stato della prenotazione in tempo reale?

Sì. Iscriviti all'evento di stato della prenotazione e ricevi il voucher non appena la prenotazione viene emessa, senza polling.

Costruisci il tuo prodotto di viaggio su un'unica API.

Integrazione gratuita. 1% per biglietto emesso, con tetto di 10 $. Copertura dal vivo di voli, hotel e attività.