Zum Inhalt springen

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/"
}
}
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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/site"

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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/catalog?from=2026-12-27&days=6"

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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/accommodations?q=Alp"

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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/courses?locale=de"

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.

Terminal-Fenster
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
}
}'

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.

Terminal-Fenster
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"
}'

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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/health"

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.

Terminal-Fenster
curl "https://skiverleih-talstation.example/api/public/gibt-es-nicht"

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/"
}
}