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.
Einrichtung
Abschnitt betitelt „Einrichtung“- In Postman Import wählen und die Collection hineinziehen. Die Umgebung ist freiwillig; die Collection bringt alle Variablen selbst mit.
- Die Collection öffnen, Reiter Variables.
apiKeyauf den eigenen Schlüssel setzen: Kennung, Punkt, Geheimnis. Der vorbelegte Wert ist erfunden und öffnet nichts. shopUrlauf die Domain des eigenen Betriebs setzen. Sie gilt für den MCP-Server und die offenen Endpunkte.- 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.
Variablen
Abschnitt betitelt „Variablen“| Variable | Vorbelegt mit | Bedeutung |
|---|---|---|
baseUrl | https://skirent.sumware.at | Adresse der Plattform. Die offene Schnittstelle hängt am Schlüssel, nicht an der Domain des Betriebs. |
apiKey | erfundener Schlüssel | Kennung, Punkt, Geheimnis. Der vorbelegte Wert ist erfunden und öffnet nichts. |
shopUrl | https://skiverleih-talstation.example | Domain des Betriebs. MCP-Server, Entwürfe und offene Endpunkte hängen an ihr. |
bookingRef | SB-261114-WWNP | Buchungsnummer. Wird von „Buchungen auflisten“ und „Eine Buchung anlegen“ gesetzt. |
date | 2026-12-27 | Tag der Tour als JJJJ-MM-TT. |
jobId | 3 | Nummer eines Auftrags. Wird von „Aufträge eines Tages“ gesetzt. |
accommodationId | 2 | Nummer einer Unterkunft. Wird von „Unterkünfte auflisten“ gesetzt. |
courseUid | 01a1db4a-b5a4-7331-84c1-5c71a25feb38 | Kennung eines Kurspostens. Wird von „Kurse auflisten“ gesetzt. |
coursesAsOf | 2026-12-20T06:00:04.782Z | Zeitpunkt des letzten Kursabrufs, für since. |
draftId | LXLJzxJzbrHmw7aIKtGIOg | Kennung eines Entwurfs. Wird von „Entwurf anlegen“ gesetzt. |
sealCode | WJ58JVBE38 | Prü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.
Automatisch gesetzte Variablen
Abschnitt betitelt „Automatisch gesetzte Variablen“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.
| Ordner | Anfragen | Inhalt |
|---|---|---|
| Offene Schnittstelle › Schlüssel | 1 | Betrieb, Schlüssel und Rechte |
| Offene Schnittstelle › Buchungen | 8 | Buchungen 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 › Tour | 5 | Aufträ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ünfte | 5 | Unterkünfte auflisten · Eine Unterkunft anlegen · Eine Unterkunft lesen · Eine Unterkunft ändern · Eine Unterkunft entfernen |
| Offene Schnittstelle › Einstellungen | 2 | Einstellungen lesen · Einstellungen ändern |
| Offene Schnittstelle › Preise | 1 | Katalog lesen |
| Offene Schnittstelle › Kurse | 4 | Kurse auflisten · Kurse auflisten: nur Änderungen seit dem letzten Abruf · Kurse auflisten: stornierte · Einen Kurs lesen |
| KI-Agenten › MCP-Server | 8 | initialize · tools/list · get_shop_info · search_rental_catalog · search_accommodations · quote_cart · create_cart_link · Server-Karte |
| KI-Agenten › Buchungsentwurf | 3 | Entwurf anlegen · Entwurf lesen · Schema des Rumpfs |
| KI-Agenten › Offene Endpunkte | 7 | Erreichbarkeit · Stammdaten · Katalog mit Preisen · Unterkünfte suchen · Kurskatalog · Preis rechnen · Prüfcode prüfen |
| Fehlerbilder | 4 | 401: ohne Schlüssel · 404: Buchung gibt es nicht · 400: Datum in falscher Form · 405: falsche Methode |
Schreibende Anfragen
Abschnitt betitelt „Schreibende Anfragen“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
accommodationIdsteht.
Wer nur ansehen will, bleibt bei den GET-Anfragen oder liest die Beispielantworten, die an jeder Anfrage hängen.
Andere Werkzeuge
Abschnitt betitelt „Andere Werkzeuge“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.