Objekte

Zusatzleistungen eines Objekts

gethttps://open-api.mynextdays.com/v1/properties/{property_id}/addons

Alle buchbaren Zusatzleistungen samt Preis und Bezugsgröße.

Die Währung kommt vom Objekt — sie steht nicht an der Leistung, und sie wird nicht erfunden. Fehlt sie am Objekt, schlägt der Aufruf fehl.

Pfad-Parameter

property_idstringpflicht

Query-Parameter

include_inactivebooleanStandard false

Auch abgeschaltete Leistungen mitliefern. Standard false — eine abgeschaltete Leistung ist nicht buchbar, und ein Client, der sie anbietet, verkauft etwas, das es nicht gibt.

Antworten

200Successful Response

basisstringpflicht

Bezugsgröße des Preises, z. B. per_stay, per_night, per_guest_stay, per_guest_night, per_pet_stay.

currencystringpflicht

Währung des Objekts (ISO 4217).

descriptionobject

idstringpflicht

mandatorybooleanpflicht

Pflichtleistung — wird bei jeder Buchung berechnet.

nameNamepflicht

Bezeichnung je Sprache (ISO 639-1 → Text). Ein leerer Wert heißt „nicht übersetzt“, nicht „ohne Namen“ — wir geben keine Sprache als eine andere aus.

pricestringpflicht

tax_ratestring

Eigener USt-Satz in Prozent, falls abweichend.

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/properties/%3Cproperty_id%3E/addons' \
  -H 'Authorization: Bearer <access_token>'

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

Beispiel

[
  {
    "id": "…",
    "name": {},
    "price": "…",
    "currency": "…",
    "basis": "…",
    "mandatory": false
  }
]