Zum Inhalt springen

Werkzeuge

Postman Collection

Die Collection enthält 48 Anfragen. Pfad, Abfrage und Rumpf sind vorbelegt, und an jeder Anfrage hängt die Antwort aus dem Mitschnitt als Beispiel. So sehen Sie die Form der Antwort, bevor Sie den ersten eigenen Aufruf senden.

  1. In Postman Import wählen und die Collection hineinziehen. Die Umgebung ist freiwillig; die Collection bringt alle Variablen selbst mit.
  2. Die Collection öffnen, Reiter Variables. apiKey auf den eigenen Schlüssel setzen: Kennung, Punkt, Geheimnis. Der vorbelegte Wert ist erfunden und öffnet nichts.
  3. shopUrl auf die Domain des eigenen Betriebs setzen. Sie gilt für den MCP-Server und die offenen Endpunkte.
  4. Offene Schnittstelle › Schlüssel › Betrieb, Schlüssel und Rechte senden. Die Antwort nennt den Betrieb und die Rechte des Schlüssels.

Der Schlüssel steht an einer Stelle: die Collection meldet sich mit Bearer {{apiKey}} an, und jede Anfrage der offenen Schnittstelle erbt das. Die Ordner für KI-Agenten senden ohne Anmeldung.

VariableVorbelegt mitBedeutung
baseUrlhttps://skirent.sumware.atAdresse der Plattform. Die offene Schnittstelle hängt am Schlüssel, nicht an der Domain des Betriebs.
apiKeyerfundener SchlüsselKennung, Punkt, Geheimnis. Der vorbelegte Wert ist erfunden und öffnet nichts.
shopUrlhttps://skiverleih-talstation.exampleDomain des Betriebs. MCP-Server, Entwürfe und offene Endpunkte hängen an ihr.
bookingRefSB-261114-WWNPBuchungsnummer. Wird von „Buchungen auflisten“ und „Eine Buchung anlegen“ gesetzt.
date2026-12-27Tag der Tour als JJJJ-MM-TT.
jobId3Nummer eines Auftrags. Wird von „Aufträge eines Tages“ gesetzt.
accommodationId2Nummer einer Unterkunft. Wird von „Unterkünfte auflisten“ gesetzt.
courseUid01a1db4a-b5a4-7331-84c1-5c71a25feb38Kennung eines Kurspostens. Wird von „Kurse auflisten“ gesetzt.
coursesAsOf2026-12-20T06:00:04.782ZZeitpunkt des letzten Kursabrufs, für since.
draftIdLXLJzxJzbrHmw7aIKtGIOgKennung eines Entwurfs. Wird von „Entwurf anlegen“ gesetzt.
sealCodeWJ58JVBE38Prüfcode einer Buchung.

Die Werte für Buchung, Auftrag, Unterkunft und Kurs stammen aus dem Beispielbetrieb. Im eigenen Betrieb gelten andere, und die Collection zieht sie selbst nach.

An den Anfragen hängen kleine Skripte. Sie prüfen den Status und schreiben, was die nächste Anfrage braucht, in die Variablen.

Anfrage setzt
Buchungen auflisten bookingRef auf die erste Buchung
Eine Buchung anlegen bookingRef auf die neue Buchung
Aufträge eines Tages jobId auf den ersten offenen Auftrag
Unterkünfte auflisten accommodationId auf das erste Haus
Kurse auflisten courseUid und coursesAsOf
Entwurf anlegen draftId

Ein guter erster Durchgang: die drei Listen senden, dann sind die Variablen gültig, und jede Anfrage mit einer Nummer im Pfad trifft einen echten Eintrag.

OrdnerAnfragenInhalt
Offene Schnittstelle › Schlüssel1Betrieb, Schlüssel und Rechte
Offene Schnittstelle › Buchungen8Buchungen auflisten · Eine Buchung anlegen · Eine Buchung anlegen: Laufkunde, Abholung im Shop · Eine Buchung lesen · Eine Buchung ändern · Eine Buchung ändern: Abreise verschieben · Stornovorschlag lesen · Eine Buchung stornieren
Offene Schnittstelle › Tour5Aufträge eines Tages · Einen Auftrag melden · Einen Auftrag melden: übersprungen, mit Grund · Einen Auftrag melden: nur eine Notiz · Einen Auftrag melden: zurücknehmen
Offene Schnittstelle › Unterkünfte5Unterkünfte auflisten · Eine Unterkunft anlegen · Eine Unterkunft lesen · Eine Unterkunft ändern · Eine Unterkunft entfernen
Offene Schnittstelle › Einstellungen2Einstellungen lesen · Einstellungen ändern
Offene Schnittstelle › Preise1Katalog lesen
Offene Schnittstelle › Kurse4Kurse auflisten · Kurse auflisten: nur Änderungen seit dem letzten Abruf · Kurse auflisten: stornierte · Einen Kurs lesen
KI-Agenten › MCP-Server8initialize · tools/list · get_shop_info · search_rental_catalog · search_accommodations · quote_cart · create_cart_link · Server-Karte
KI-Agenten › Buchungsentwurf3Entwurf anlegen · Entwurf lesen · Schema des Rumpfs
KI-Agenten › Offene Endpunkte7Erreichbarkeit · Stammdaten · Katalog mit Preisen · Unterkünfte suchen · Kurskatalog · Preis rechnen · Prüfcode prüfen
Fehlerbilder4401: ohne Schlüssel · 404: Buchung gibt es nicht · 400: Datum in falscher Form · 405: falsche Methode

Die Collection sendet an den Betrieb, zu dem der Schlüssel gehört. POST, PATCH und DELETE ändern dessen Daten.

  • Eine Buchung anlegen legt wirklich eine an, mit Aufträgen für Lieferung und Abholung. Die Codes der Modelle im Rumpf stammen aus dem Katalog des Beispielbetriebs; ersetzen Sie sie durch Codes aus Preise › Katalog lesen.
  • Eine Buchung stornieren storniert die Buchung in bookingRef.
  • Eine Unterkunft entfernen löscht oder legt still, was in accommodationId steht.

Wer nur ansehen will, bleibt bei den GET-Anfragen oder liest die Beispielantworten, die an jeder Anfrage hängen.

Die Collection ist eine JSON-Datei im Format v2.1 und lässt sich in andere Werkzeuge importieren, die dieses Format lesen. Dieselben Anfragen stehen auf jeder Seite der Referenz als cURL, JavaScript, Python und PHP.