Buchungen

Portal-Daten einer Buchung

gethttps://open-api.mynextdays.com/v1/reservations/{reservation_id}/external

Was das Portal geliefert hat — unverändert, samt Provision und Abgaben.

Für den Fall, dass ein Feld gebraucht wird, das diese API nicht abbildet.

Warnung, die zum Endpunkt gehört: details ist NICHT stabil. Es ist, was das Portal schickt, und es ändert sich, wenn das Portal sich ändert. Alles, was hier als eigenes Feld steht (booked_at, commission, payment_collect), ist dagegen unsere Zusage — darauf lässt sich bauen.

booked_at und received_at stehen beide dabei und bedeuten Verschiedenes: der eine ist der Zeitpunkt beim Gast, der andere unser Eingang. Bei einem Sammel-Abruf tragen Dutzende Buchungen dieselbe received_at-Sekunde.

Pfad-Parameter

reservation_idstringpflicht

Antworten

200Successful Response

booked_atdate-time

Wann der Gast beim Portal gebucht hat.

channelstringpflicht

commissionstring

Provision des Portals, wie es sie meldet.

detailsobject

Die Rohdaten des Portals.

external_refstring

Buchungsnummer beim Portal.

notesstring

ota_namestring

payment_collectstring

Wer das Geld einzieht: Portal oder Betrieb.

received_atdate-time

Wann die Buchung bei uns eingegangen ist.

reservation_idstringpflicht

withheld_taxesstring

Abgaben, die das Portal einbehält.

404Die Buchung gibt es nicht — oder sie kam nicht über ein Portal. Für eine Direktbuchung gibt es hier nichts zu holen.

422Validation Error

detailarray of ValidationError

ctxContext

inputInput

locarray of string | integerpflicht

msgstringpflicht

typestringpflicht

Sprache

Zugang

Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.

Anfrage

curl -X GET 'https://open-api.mynextdays.com/v1/reservations/%3Creservation_id%3E/external' \
  -H 'Authorization: Bearer <access_token>'

Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.

Beispiel

{
  "reservation_id": "…",
  "channel": "…"
}