KI-Agenten
Offene Endpunkte
Auf der Domain jedes Betriebs gibt es Endpunkte, die ohne Anmeldung lesen und rechnen. Sie bedienen die Website des Betriebs und jeden Assistenten, der für einen Gast nachsieht.
https://skiverleih-talstation.example/api/public/…
Den Betrieb bestimmt der Host. Ein Host, der zu keinem Betrieb gehört, bekommt 404 und nicht den erstbesten Betrieb:
Antwort404Not Found
{ "error": { "code": "not_found", "message": "Unter dieser Adresse ist kein Verleih erreichbar.", "status": 404, "hint": "Kein Eintrag zu \"unbekannt.example\".", "documentation_url": "https://unbekannt.example/api/" }}Übersicht
Abschnitt betitelt „Übersicht“| Methode | Pfad | Wofür |
|---|---|---|
GET |
/api/public/site |
Stammdaten: Name, Adresse, Zeiten, Saison, Sprachen, Skischule |
GET |
/api/public/catalog |
Katalog mit Preisen am Stichtag |
GET |
/api/public/accommodations |
Unterkünfte im Liefergebiet |
GET |
/api/public/courses |
Kurskatalog der Skischule |
GET |
/api/public/shop |
Artikel zum Kauf, wenn der Betrieb das Modul führt |
GET |
/api/public/directions |
Weg von einer Unterkunft zum Shop, für die Abholung |
POST |
/api/public/quote |
Preis einer Auswahl rechnen |
POST |
/api/public/cart-shares |
Warenkorb als kurzen Link teilen |
GET |
/api/public/verify |
Prüfcode einer Buchung prüfen |
POST |
/api/agent/drafts |
Buchungsentwurf anlegen |
Die aktuelle Liste mit Parametern liefert jede Domain selbst unter /api/, siehe Maschinenlesbare Seiten.
Stammdaten
Abschnitt betitelt „Stammdaten“curl "https://skiverleih-talstation.example/api/public/site"const res = await fetch("https://skiverleih-talstation.example/api/public/site");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/site", timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/site');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "name": "Skiverleih Talstation", "legalName": "Skiverleih Talstation GmbH", "owner": "Skiverleih Talstation GmbH", "url": "https://skiverleih-talstation.example", "email": "office@skiverleih-talstation.example", "phone": "+43 000 000000", "phoneHref": "tel:+43000000000", "whatsappHref": "", "address": { "street": "Liftstraße 1", "zip": "5999", "city": "Bergdorf", "region": "Salzburg", "country": "AT" }, "geo": { "lat": 47.2501, "lng": 13.2002 }, "warehouseGeo": { "lat": 47.2501, "lng": 13.2002 }, "mapsUrl": "", "vatId": "ATU00000000", "sameAs": [], "priceRange": "€€", "currency": "EUR", "season": { "start": "11-28", "end": "04-18" }}Gezeigt ist der Teil site der Antwort.
Die volle Antwort trägt außerdem, was die Website zum Rendern braucht: Farben, Bausteine der Startseite, Texte. Für ein fremdes Programm zählen site, hours, school, locales und modules.
Katalog mit Preisen
Abschnitt betitelt „Katalog mit Preisen“curl "https://skiverleih-talstation.example/api/public/catalog?from=2026-12-27&days=6"const res = await fetch("https://skiverleih-talstation.example/api/public/catalog?from=2026-12-27&days=6");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/catalog", params={"from": "2026-12-27", "days": "6"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/catalog?from=2026-12-27&days=6');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
Antwort anzeigen 203 Zeilen
{ "shop": "Skiverleih Talstation", "from": "2026-12-27", "days": 6, "currency": "EUR", "categories": [ { "code": "ski", "label": "Ski", "kind": "ski", "required": true, "sizeKind": "height", "intro": "Alle Ski kommen frisch geschliffen und gewachst. Die Bindung stellen wir nach ISO 11088 auf dich ein.", "damageWaiverPercent": 10, "models": [ { "code": "ski-comfort", "label": "Comfort", "pitch": "Gutmütige Allrounder für die blaue und rote Piste. Verzeihen Fehler und bringen dich sicher runter.", "tier": "comfort", "image": null, "ladders": { "adult": { "daysCents": [ 2400, 4600, 6600, 8400, 10000, 11400 ], "extraDayCents": 1200 }, "child": { "daysCents": [ 900, 1700, 2400, 3000, 3500, 3900 ], "extraDayCents": 400 }, "youth": { "daysCents": [ 1200, 2200, 3100, 3900, 4600, 5200 ], "extraDayCents": 600 } }, "priceBands": [ "child", "youth", "adult" ] }, { "code": "ski-prime", "label": "Prime", "pitch": "Aktuelle Modelle der oberen Mittelklasse. Mehr Kantengriff und ruhiger bei Tempo, für alle die zügig fahren.", "tier": "prime", "image": null, "ladders": { "adult": { "daysCents": [ 3000, 5800, 8400, 10700, 12700, 14400 ], "extraDayCents": 1500 } }, "priceBands": [ "adult" ] } ] }, { "code": "snowboard", "label": "Snowboard", "kind": "snowboard", "required": true, "sizeKind": "height", "intro": "Boards für Piste und Powder, Bindung auf deinen Stand eingestellt.", "damageWaiverPercent": 10, "models": [ { "code": "snowboard-comfort", "label": "Comfort", "pitch": "Weiche, drehfreudige Allmountain-Boards. Ideal zum Lernen und für entspannte Pistentage.", "tier": "comfort", "image": null, "ladders": { "adult": { "daysCents": [ 2400, 4600, 6600, 8400, 10000, 11400 ], "extraDayCents": 1200 }, "youth": { "daysCents": [ 1200, 2200, 3100, 3900, 4600, 5200 ], "extraDayCents": 600 } }, "priceBands": [ "youth", "adult" ] }, { "code": "snowboard-prime", "label": "Prime", "pitch": "Stabilere Boards mit mehr Pop. Für sicheres Fahren bei Tempo und den Ausflug in den Park.", "tier": "prime", "image": null, "ladders": { "adult": { "daysCents": [ 3000, 5800, 8400, 10700, 12700, 14400 ], "extraDayCents": 1500 } }, "priceBands": [ "adult" ] } ] } ], "rules": { "childMaxAge": 6, "youthMaxAge": 14, "helmetFreeMaxAge": 12, "polesFreeWith": "ski", "depositCents": 0, "waiverPercent": 10, "lateReturnFeeCents": 500, "vatPercent": 20, "familyChildMaxAge": 10, "familyRequiredAdults": 2, "earlyPercent": null, "earlyLeadDays": null, "promoPercent": null, "ageMode": "exact" }, "times": { "returnTime": "18:00", "lateReturnTime": "10:00" }, "services": [ { "code": "service-small", "adultCents": 3000, "childCents": 2000, "boardCents": 3800 }, { "code": "service-large", "adultCents": 4200, "childCents": 3000, "boardCents": 5000 } ], "cancelTiers": [ { "minDaysBefore": 60, "feePercent": 0 }, { "minDaysBefore": 30, "feePercent": 25 } ], "fetchedAt": "2026-11-14T18:03:12.998Z"}categories zeigt 2 von 9 Einträgen. categories[].models zeigt 2 von 3 Einträgen. services zeigt 2 von 6 Einträgen. cancelTiers zeigt 2 von 4 Einträgen.
Derselbe Katalog wie unter Katalog und Preise, hier über den Host des Betriebs. Jedes Modell trägt zusätzlich priceBands: die Altersbänder, für die es einen eigenen Preis hat.
Der Katalog ist in jeder Sprache derselbe. Beschriftungen kommen in der Standardsprache des Betriebs.
Unterkünfte suchen
Abschnitt betitelt „Unterkünfte suchen“curl "https://skiverleih-talstation.example/api/public/accommodations?q=Alp"const res = await fetch("https://skiverleih-talstation.example/api/public/accommodations?q=Alp");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/accommodations", params={"q": "Alp"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/accommodations?q=Alp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "accommodationRequired": true, "items": [ { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf", "district": "Oberdorf", "isDepot": false, "delivery": null }, { "id": 1, "name": "Kein Hotel, Abholung im Shop", "street": "Liftstraße 1", "zip": "5999", "city": "Bergdorf", "district": null, "isDepot": true, "delivery": null } ]}q sucht im Namen, limit begrenzt die Liste, id holt genau eine Unterkunft. delivery nennt die Lieferzone und ihre Gebühr in Cent, wenn der Betrieb Zonen führt. Der Eintrag mit isDepot steht für die Abholung im Shop.
Die öffentliche Liste nennt keine Telefonnummern und keine Hinweise für den Fahrer.
Kurskatalog
Abschnitt betitelt „Kurskatalog“curl "https://skiverleih-talstation.example/api/public/courses?locale=de"const res = await fetch("https://skiverleih-talstation.example/api/public/courses?locale=de");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/courses", params={"locale": "de"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/courses?locale=de');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
Antwort anzeigen 81 Zeilen
{ "school": { "id": "", "name": "Skischule Bergdorf", "slug": "", "email": "buero@skischule-bergdorf.example", "phone": "+43 000 000020" }, "earlyBooking": { "percent": 0, "leadDays": 0 }, "meetingPoints": [ { "id": "schule", "name": "Treffpunkt der Skischule", "city": "5999 Bergdorf", "lat": 47.2509, "lng": 13.2008 } ], "courses": [ { "id": "kinder-3t", "name": "Kinderkurs, 3 Tage", "descriptionShort": "Drei Vormittage Skikurs für Kinder, in Gruppen nach Können.", "description": "Montag bis Mittwoch, jeweils am Vormittag. Die Gruppen werden am ersten Tag eingeteilt. Der Preis gilt je Kind.", "priceType": "group", "isPackage": false, "includedPersons": 1, "image": null, "template": { "id": "group", "name": "" }, "languages": [ "de", "en" ], "skills": [ { "id": "beginner", "name": "Anfänger", "short": "Anfänger" } ], "variants": [ { "id": "1", "durationDays": 3, "durationHours": 2.5, "timeFrom": "10:00", "priceCents": 19500, "priceSurchargeCents": 19500 } ], "availability": [ { "dateFrom": "2026-11-28", "dateTo": "2027-04-18", "runsOn": [ 1, 2, 3 ], "startsOn": [ 1 ] } ], "blockedPeriods": [], "meetingPointIds": [ "schule" ], "priceFromCents": 19500, "demo": false } ], "seasonFrom": "2026-11-28", "fetchedAt": "2026-11-14T18:03:15.738Z"}courses zeigt 1 von 2 Einträgen. courses[].skills zeigt 1 von 3 Einträgen.
Je Kurs die Varianten mit Dauer, Beginn und Preis, die Tage, an denen er läuft und beginnt, die Niveaus und die Treffpunkte.
Preisberechnung
Abschnitt betitelt „Preisberechnung“curl -X POST "https://skiverleih-talstation.example/api/public/quote" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Martin", "lastName": "Berger", "age": 41, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "skierType": "II" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-comfort" }, { "categoryCode": "skiboots", "modelCode": "skiboots-comfort" } ], "poles": true, "damageWaiver": false }, { "kind": "rental", "id": "p2", "from": "2026-12-27", "days": 6, "person": { "firstName": "Julia", "lastName": "Berger", "age": 38, "heightCm": 168, "weightKg": 62, "shoeSize": "38.5", "skierType": "II" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-comfort" }, { "categoryCode": "skiboots", "modelCode": "skiboots-comfort" } ], "poles": true, "damageWaiver": false }, { "kind": "rental", "id": "p3", "from": "2026-12-27", "days": 6, "person": { "firstName": "Leon", "lastName": "Berger", "age": 11, "heightCm": 146, "weightKg": 38, "shoeSize": "36", "skierType": "I", "headSize": "54" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-comfort" }, { "categoryCode": "skiboots", "modelCode": "skiboots-comfort" }, { "categoryCode": "helmet", "modelCode": "helmet" } ], "poles": false, "damageWaiver": false } ], "locale": "de", "stay": { "accommodationId": 2 } }'const res = await fetch("https://skiverleih-talstation.example/api/public/quote", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ items: [ { kind: "rental", id: "p1", from: "2026-12-27", days: 6, person: { firstName: "Martin", lastName: "Berger", age: 41, heightCm: 182, weightKg: 84, shoeSize: "44", skierType: "II", }, selections: [ { categoryCode: "ski", modelCode: "ski-comfort" }, { categoryCode: "skiboots", modelCode: "skiboots-comfort" }, ], poles: true, damageWaiver: false, }, { kind: "rental", id: "p2", from: "2026-12-27", days: 6, person: { firstName: "Julia", lastName: "Berger", age: 38, heightCm: 168, weightKg: 62, shoeSize: "38.5", skierType: "II", }, selections: [ { categoryCode: "ski", modelCode: "ski-comfort" }, { categoryCode: "skiboots", modelCode: "skiboots-comfort" }, ], poles: true, damageWaiver: false, }, { kind: "rental", id: "p3", from: "2026-12-27", days: 6, person: { firstName: "Leon", lastName: "Berger", age: 11, heightCm: 146, weightKg: 38, shoeSize: "36", skierType: "I", headSize: "54", }, selections: [ { categoryCode: "ski", modelCode: "ski-comfort" }, { categoryCode: "skiboots", modelCode: "skiboots-comfort" }, { categoryCode: "helmet", modelCode: "helmet" }, ], poles: false, damageWaiver: false, }, ], locale: "de", stay: { accommodationId: 2 }, }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/api/public/quote", json={ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Martin", "lastName": "Berger", "age": 41, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "skierType": "II", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-comfort"}, {"categoryCode": "skiboots", "modelCode": "skiboots-comfort"}, ], "poles": True, "damageWaiver": False, }, { "kind": "rental", "id": "p2", "from": "2026-12-27", "days": 6, "person": { "firstName": "Julia", "lastName": "Berger", "age": 38, "heightCm": 168, "weightKg": 62, "shoeSize": "38.5", "skierType": "II", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-comfort"}, {"categoryCode": "skiboots", "modelCode": "skiboots-comfort"}, ], "poles": True, "damageWaiver": False, }, { "kind": "rental", "id": "p3", "from": "2026-12-27", "days": 6, "person": { "firstName": "Leon", "lastName": "Berger", "age": 11, "heightCm": 146, "weightKg": 38, "shoeSize": "36", "skierType": "I", "headSize": "54", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-comfort"}, {"categoryCode": "skiboots", "modelCode": "skiboots-comfort"}, {"categoryCode": "helmet", "modelCode": "helmet"}, ], "poles": False, "damageWaiver": False, }, ], "locale": "de", "stay": {"accommodationId": 2}, }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/quote');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'items' => [ [ 'kind' => 'rental', 'id' => 'p1', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Martin', 'lastName' => 'Berger', 'age' => 41, 'heightCm' => 182, 'weightKg' => 84, 'shoeSize' => '44', 'skierType' => 'II', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-comfort'], ['categoryCode' => 'skiboots', 'modelCode' => 'skiboots-comfort'], ], 'poles' => true, 'damageWaiver' => false, ], [ 'kind' => 'rental', 'id' => 'p2', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Julia', 'lastName' => 'Berger', 'age' => 38, 'heightCm' => 168, 'weightKg' => 62, 'shoeSize' => '38.5', 'skierType' => 'II', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-comfort'], ['categoryCode' => 'skiboots', 'modelCode' => 'skiboots-comfort'], ], 'poles' => true, 'damageWaiver' => false, ], [ 'kind' => 'rental', 'id' => 'p3', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Leon', 'lastName' => 'Berger', 'age' => 11, 'heightCm' => 146, 'weightKg' => 38, 'shoeSize' => '36', 'skierType' => 'I', 'headSize' => '54', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-comfort'], ['categoryCode' => 'skiboots', 'modelCode' => 'skiboots-comfort'], ['categoryCode' => 'helmet', 'modelCode' => 'helmet'], ], 'poles' => false, 'damageWaiver' => false, ], ], 'locale' => 'de', 'stay' => ['accommodationId' => 2], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
Antwort anzeigen 68 Zeilen
{ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Martin", "lastName": "Berger", "age": 41, "ageGroup": null, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "headSize": null, "skierType": "II", "ownBoots": false, "bootSoleMm": null, "wideFeet": false }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-comfort" } ], "poles": true, "damageWaiver": false, "lateReturn": false } ], "totals": { "items": [ { "itemId": "p1", "kind": "rental", "title": "Martin Berger", "subtitle": "Verleih · ab 27.12.2026 · 6 Tage", "lines": [ { "label": "Ski Comfort", "detail": "6 Tage", "amountCents": 11400, "lineKind": "equipment", "categoryCode": "ski", "modelCode": "ski-comfort", "ageBand": "adult" } ], "totalCents": 15900, "depositCents": 0 } ], "totalCents": 39000, "depositCents": 0, "brokeredCents": 0, "vatCents": 6500, "vatPercent": 20, "articleCents": 0, "articleVatCents": 0, "familyHint": null, "payableCents": 39000, "currency": "EUR", "discounts": [], "delivery": null }}items zeigt 1 von 3 Einträgen. items[].selections zeigt 1 von 2 Einträgen. totals.items zeigt 1 von 3 Einträgen. totals.items[].lines zeigt 1 von 3 Einträgen.
Positionen hinein, geprüfte Summe heraus. Der Aufruf schreibt nichts. Mit stay.accommodationId rechnet er die Liefergebühr der Zone mit.
Die Summe im Beispiel: zweimal € 159,00 für die Erwachsenen und € 72,00 für das Kind, zusammen € 390,00. Je Adresse gehen 60 Aufrufe in der Minute.
Warenkorb teilen
Abschnitt betitelt „Warenkorb teilen“curl -X POST "https://skiverleih-talstation.example/api/public/cart-shares" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Martin", "lastName": "Berger", "age": 41, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "skierType": "II" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-comfort" }, { "categoryCode": "skiboots", "modelCode": "skiboots-comfort" } ], "poles": true, "damageWaiver": false } ], "locale": "de" }'const res = await fetch("https://skiverleih-talstation.example/api/public/cart-shares", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ items: [ { kind: "rental", id: "p1", from: "2026-12-27", days: 6, person: { firstName: "Martin", lastName: "Berger", age: 41, heightCm: 182, weightKg: 84, shoeSize: "44", skierType: "II", }, selections: [ { categoryCode: "ski", modelCode: "ski-comfort" }, { categoryCode: "skiboots", modelCode: "skiboots-comfort" }, ], poles: true, damageWaiver: false, }, ], locale: "de", }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/api/public/cart-shares", json={ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Martin", "lastName": "Berger", "age": 41, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "skierType": "II", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-comfort"}, {"categoryCode": "skiboots", "modelCode": "skiboots-comfort"}, ], "poles": True, "damageWaiver": False, }, ], "locale": "de", }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/cart-shares');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'items' => [ [ 'kind' => 'rental', 'id' => 'p1', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Martin', 'lastName' => 'Berger', 'age' => 41, 'heightCm' => 182, 'weightKg' => 84, 'shoeSize' => '44', 'skierType' => 'II', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-comfort'], ['categoryCode' => 'skiboots', 'modelCode' => 'skiboots-comfort'], ], 'poles' => true, 'damageWaiver' => false, ], ], 'locale' => 'de', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort201Created
{ "id": "8F75U7Zu5uHksBellgiBOQ", "url": "https://skiverleih-talstation.example/w/8F75U7Zu5uHksBellgiBOQ", "expiresAt": "2026-11-15T18:03:19.848Z"}Legt einen kurzen Link an, der die Positionen in den Warenkorb des Empfängers legt. Kontakt und Aufenthalt gehen nicht mit, weil der Link bei jemand anderem landet. Der Link gilt 24 Stunden.
Erreichbarkeit
Abschnitt betitelt „Erreichbarkeit“curl "https://skiverleih-talstation.example/api/public/health"const res = await fetch("https://skiverleih-talstation.example/api/public/health");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/health", timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/health');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "ok": true, "tenant": "talstation", "name": "Skiverleih Talstation", "currency": "EUR", "locale": "de"}Nennt den Betrieb hinter der Domain. Der billigste Aufruf, um zu prüfen, ob eine Domain zu einem Betrieb auf Ski4me gehört.
Die Fehler haben dieselbe Hülle wie überall. documentation_url zeigt auf die Liste der Endpunkte dieser Domain.
curl "https://skiverleih-talstation.example/api/public/gibt-es-nicht"const res = await fetch("https://skiverleih-talstation.example/api/public/gibt-es-nicht");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/api/public/gibt-es-nicht", timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/api/public/gibt-es-nicht');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort404Not Found
{ "error": { "code": "not_found", "message": "Unter diesem Pfad ist kein Endpunkt veröffentlicht.", "status": 404, "hint": "Die Liste der Endpunkte steht unter https://skiverleih-talstation.example/api/.", "documentation_url": "https://skiverleih-talstation.example/api/" }}