Aktivitäten-API

Touren, Attraktionen und Erlebnisse

Katalog durchsuchen, Verfügbarkeit nach Datum und Zeitfenster prüfen, buchen und Voucher übergeben. Ein REST-Ablauf, Preise in USD.

API-ReferenzZum Guide
GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Überblick

Aktivitäten-Content ist umfangreich und Verfügbarkeit ist zeitkritisch. Diese Aktivitäten-API bietet einen durchsuchbaren Katalog, Verfügbarkeit pro Datum und Zeitfenster mit herausgefilterten Vergangenheitszeiten, einen einfachen Buchungsablauf und herunterladbare Voucher.

Die Aktivitäten-API umschließt einen tiefen Katalog an Erlebnissen mit echter, zeitbewusster Verfügbarkeit. Kategorien, Sprachen, Dauer, Preisstufen und Verfügbarkeit je Zeitfenster werden zu einem Ablauf vereint, sodass Sie eine Stadtführung oder einen Tagesausflug mit demselben Code-Pfad verkaufen wie Flüge und Hotels.

Das bekommen Sie

1

Durchsuchen Sie den Katalog nach Stadt, Kategorie, Preis und Sprache.

2

Lesen Sie buchbare Daten und Zeitfenster, bereits gegen die lokale Zeit der Aktivität gefiltert.

3

Buchung erstellen, bestätigen und Voucher herunterladen.

4

Die Verfügbarkeit wird gegen die lokale Zeit jeder Aktivität gefiltert, sodass vergangene Zeitfenster nie erscheinen.

5

Herunterladbare Voucher und ein Buchungsstatus-Event, das Sie abonnieren können, statt zu pollen.

So läuft der Ablauf

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.

Wichtige Endpunkte

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.

Anfrage und Antwort

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" }
      ]
    }
  ]
}

Was die Antwort enthält

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+

Aktivitäten an Reisezielen weltweit

Häufige Fragen

Wie wird Verfügbarkeit geliefert?

Als buchbare Daten und als Zeitfenster für ein gewähltes Datum. Bereits Vergangenes wird gegen die lokale Zeit der Aktivität entfernt.

Was ist ein Product-Type?

Eine buchbare Variante eines Produkts, etwa eine Ticketstufe oder ein Paket. Sie buchen über dessen ID.

Wann erhalte ich den Voucher?

Sobald die Buchung ausgestellt ist. Statt zu pollen, können Sie das Buchungsstatus-Event beobachten.

Wie funktionieren Produkttypen?

Ein Produkttyp ist eine buchbare Variante, etwa ein Erwachsenenticket oder ein Paket. Sie buchen über seinen Code zusammen mit der Reisendenzahl.

Erhalte ich den Buchungsstatus in Echtzeit?

Ja. Abonnieren Sie das Buchungsstatus-Event und erhalten Sie den Voucher, sobald die Buchung ausgestellt ist, ganz ohne Polling.

Weiter erkunden

Flug-API

Flugsuche und Buchung, von Anfang bis Ende

Hotel-API

Hotelsuche, Tarife und Buchung

API-Referenz

Eine Anfrage zum Start

Bauen Sie Ihr Reiseprodukt auf einer API.

Kostenlos integrieren. 1 % pro ausgestelltem Ticket, gedeckelt bei 10 $. Live-Abdeckung für Flüge, Hotels und Aktivitäten.

Zur DokuVertrieb kontaktieren