@dealsystem/site 0.0.0-stage → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +145 -2
- package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
- package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
- package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
- package/agent-files/claude/skills/erster-entwurf/SKILL.md +54 -0
- package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
- package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
- package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
- package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
- package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
- package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
- package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
- package/agent-files/claude/skills/veroeffentlichen/SKILL.md +38 -0
- package/agent-files/cursor/rules/dealsystem.mdc +7 -0
- package/agent-files/manifest.json +101 -0
- package/contract/README.md +41 -0
- package/contract/ds-content.v1.json +2355 -0
- package/contract/external-presets.v1.json +65 -0
- package/contract/funnel-code-config.md +87 -0
- package/contract/site-api.v1.json +3916 -0
- package/dist/client/altcha-workers.d.ts +10 -0
- package/dist/client/attribution.d.ts +119 -0
- package/dist/client/attribution.js +341 -0
- package/dist/client/bookingClient.svelte.d.ts +166 -0
- package/dist/client/bookingClient.svelte.js +369 -0
- package/dist/client/bookingTime.d.ts +46 -0
- package/dist/client/bookingTime.js +109 -0
- package/dist/client/captcha.d.ts +26 -0
- package/dist/client/captcha.js +71 -0
- package/dist/client/captchaSession.d.ts +21 -0
- package/dist/client/captchaSession.js +105 -0
- package/dist/client/collections.d.ts +34 -0
- package/dist/client/collections.js +40 -0
- package/dist/client/externalScript.d.ts +20 -0
- package/dist/client/externalScript.js +36 -0
- package/dist/client/funnelState.svelte.d.ts +47 -0
- package/dist/client/funnelState.svelte.js +81 -0
- package/dist/client/leadClient.svelte.d.ts +131 -0
- package/dist/client/leadClient.svelte.js +250 -0
- package/dist/client/pageview.d.ts +7 -0
- package/dist/client/pageview.js +44 -0
- package/dist/client/siteApi.d.ts +211 -0
- package/dist/client/siteApi.js +320 -0
- package/dist/client/tracking.d.ts +18 -0
- package/dist/client/tracking.js +93 -0
- package/dist/client/validation.d.ts +10 -0
- package/dist/client/validation.js +66 -0
- package/dist/components/Booker.svelte +729 -0
- package/dist/components/Booker.svelte.d.ts +42 -0
- package/dist/components/CollectionList.svelte +122 -0
- package/dist/components/CollectionList.svelte.d.ts +65 -0
- package/dist/components/ConsentGate.svelte +68 -0
- package/dist/components/ConsentGate.svelte.d.ts +44 -0
- package/dist/components/CookieBanner.svelte +303 -0
- package/dist/components/CookieBanner.svelte.d.ts +29 -0
- package/dist/components/Datenschutz.svelte +84 -0
- package/dist/components/Datenschutz.svelte.d.ts +26 -0
- package/dist/components/Embed.svelte +263 -0
- package/dist/components/Embed.svelte.d.ts +41 -0
- package/dist/components/ExternalScript.svelte +94 -0
- package/dist/components/ExternalScript.svelte.d.ts +41 -0
- package/dist/components/Impressum.svelte +59 -0
- package/dist/components/Impressum.svelte.d.ts +25 -0
- package/dist/components/LeadForm.svelte +475 -0
- package/dist/components/LeadForm.svelte.d.ts +35 -0
- package/dist/components/LeadHoneypot.svelte +43 -0
- package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
- package/dist/components/Link.svelte +48 -0
- package/dist/components/Link.svelte.d.ts +30 -0
- package/dist/components/MapEmbed.svelte +154 -0
- package/dist/components/MapEmbed.svelte.d.ts +28 -0
- package/dist/components/MediaImage.svelte +218 -0
- package/dist/components/MediaImage.svelte.d.ts +128 -0
- package/dist/components/MediaVideo.svelte +103 -0
- package/dist/components/MediaVideo.svelte.d.ts +20 -0
- package/dist/components/RichText.svelte +105 -0
- package/dist/components/RichText.svelte.d.ts +55 -0
- package/dist/components/Seo.svelte +89 -0
- package/dist/components/Seo.svelte.d.ts +45 -0
- package/dist/components/SiteFooterLegal.svelte +75 -0
- package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
- package/dist/components/SiteHead.svelte +79 -0
- package/dist/components/SiteHead.svelte.d.ts +32 -0
- package/dist/components/Text.svelte +100 -0
- package/dist/components/Text.svelte.d.ts +55 -0
- package/dist/components/Tracking.svelte +30 -0
- package/dist/components/Tracking.svelte.d.ts +14 -0
- package/dist/components/Zeitfenster.svelte +92 -0
- package/dist/components/Zeitfenster.svelte.d.ts +34 -0
- package/dist/components/legal.d.ts +12 -0
- package/dist/components/legal.js +27 -0
- package/dist/config/index.d.ts +121 -0
- package/dist/config/index.js +602 -0
- package/dist/config/static/index.d.ts +3 -0
- package/dist/config/static/index.js +5 -0
- package/dist/config/static/lines.d.ts +9 -0
- package/dist/config/static/lines.js +22 -0
- package/dist/config/static/literal.d.ts +45 -0
- package/dist/config/static/literal.js +175 -0
- package/dist/config/static/siteConfig.d.ts +39 -0
- package/dist/config/static/siteConfig.js +150 -0
- package/dist/consent/consent.svelte.d.ts +91 -0
- package/dist/consent/consent.svelte.js +221 -0
- package/dist/content/index.d.ts +123 -0
- package/dist/content/index.js +247 -0
- package/dist/contentBlock.d.ts +45 -0
- package/dist/contentBlock.js +78 -0
- package/dist/csp/index.d.ts +27 -0
- package/dist/csp/index.js +74 -0
- package/dist/external/csp.d.ts +25 -0
- package/dist/external/csp.js +104 -0
- package/dist/external/hosts.d.ts +30 -0
- package/dist/external/hosts.js +128 -0
- package/dist/external/presets.d.ts +54 -0
- package/dist/external/presets.js +212 -0
- package/dist/external/resolve.d.ts +39 -0
- package/dist/external/resolve.js +254 -0
- package/dist/index.d.ts +32 -0
- package/dist/index.js +32 -0
- package/dist/internal/consentNeed.d.ts +21 -0
- package/dist/internal/consentNeed.js +50 -0
- package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
- package/dist/internal/dealsystem-legal-imprint.js +5 -0
- package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
- package/dist/internal/dealsystem-legal-privacy.js +5 -0
- package/dist/internal/dealsystem-site-data.d.ts +3 -0
- package/dist/internal/dealsystem-site-data.js +2 -0
- package/dist/internal/imprint.d.ts +4 -0
- package/dist/internal/imprint.js +10 -0
- package/dist/internal/mediaImage.d.ts +15 -0
- package/dist/internal/mediaImage.js +22 -0
- package/dist/internal/privacy.d.ts +4 -0
- package/dist/internal/privacy.js +10 -0
- package/dist/internal/providers.d.ts +9 -0
- package/dist/internal/providers.js +44 -0
- package/dist/internal/reload.d.ts +2 -0
- package/dist/internal/reload.js +5 -0
- package/dist/internal/seo.d.ts +41 -0
- package/dist/internal/seo.js +79 -0
- package/dist/internal/siteData.d.ts +7 -0
- package/dist/internal/siteData.js +39 -0
- package/dist/internal/usage.d.ts +7 -0
- package/dist/internal/usage.js +13 -0
- package/dist/keys.d.ts +20 -0
- package/dist/keys.js +58 -0
- package/dist/leadmagnet.d.ts +16 -0
- package/dist/leadmagnet.js +28 -0
- package/dist/paths.d.ts +8 -0
- package/dist/paths.js +9 -0
- package/dist/richtext/escape.d.ts +4 -0
- package/dist/richtext/escape.js +18 -0
- package/dist/richtext/server.d.ts +16 -0
- package/dist/richtext/server.js +123 -0
- package/dist/schedule.d.ts +23 -0
- package/dist/schedule.js +67 -0
- package/dist/slots.d.ts +9 -0
- package/dist/slots.js +38 -0
- package/dist/snapshot.d.ts +14 -0
- package/dist/snapshot.js +214 -0
- package/dist/types.d.ts +550 -0
- package/dist/types.js +4 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +2 -0
- package/dist/vite/index.d.ts +85 -0
- package/dist/vite/index.js +641 -0
- package/dist/vite/scan.d.ts +47 -0
- package/dist/vite/scan.js +355 -0
- package/dist/vite/zeitfenster.d.ts +18 -0
- package/dist/vite/zeitfenster.js +76 -0
- package/docs/ablauf.md +191 -0
- package/docs/agents-block.md +101 -0
- package/docs/befehle.md +103 -0
- package/docs/extern.md +143 -0
- package/docs/gestaltung.md +139 -0
- package/docs/inhalte.md +224 -0
- package/docs/komponenten.md +1273 -0
- package/docs/konfiguration.md +310 -0
- package/docs/llms.txt +19 -0
- package/docs/rechtstexte.md +84 -0
- package/docs/regeln.md +108 -0
- package/docs/seo.md +55 -0
- package/docs/termine.md +73 -0
- package/package.json +115 -5
|
@@ -0,0 +1,3916 @@
|
|
|
1
|
+
{
|
|
2
|
+
"openapi": "3.1.0",
|
|
3
|
+
"info": {
|
|
4
|
+
"title": "DealSystem Site-API (Self-Service-Websites)",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"description": "Öffentliche API für **selbst gebaute Websites** (Self-Service). Aufgerufen nur vom SDK `@dealsystem/site` im Browser.\n\n## Zugang\n\n- **Publishable Key** `dsp_…` im Pfad. Er ist **kein Geheimnis** — er steht in jeder ausgelieferten Seite und öffnet nur diese\n Endpunkte für genau eine Seite: veröffentlichte Inhalte lesen (Sammlungen), Captcha-Challenge holen, Formulare einreichen,\n Seitenaufrufe zählen.\n- **Origin** muss eine Domain der Seite sein: nachgewiesene, aktive eigene Domain, Standard-Host `<slug>.<SITES_DOMAIN>` oder\n Vorschau-Host `<slug>--<token>.<SITES_DOMAIN>` einer gebauten Version (dann `dryRun`). Sonst 403 `origin_not_allowed`.\n- Keine Cookies, keine Sitzung. Antworten tragen `Access-Control-Allow-Origin: <Origin>`, `Vary: Origin`, nie\n `Access-Control-Allow-Credentials`. `Retry-After` ist freigegeben (`Access-Control-Expose-Headers`); auch ein 429 des\n IP-Limits vor der Schlüssel-Prüfung trägt den `Origin` zurück, damit der Browser es lesen kann.\n- Lokale Entwicklung läuft nicht hierüber, sondern über den Dev-Proxy der CLI (`dealsystem dev`).\n\n## Konventionen\n\nErfolg `{ \"data\": … }` (bewusste Ausnahme: `GET …/captcha` liefert die ALTCHA-Challenge ohne Hülle, weil das Widget die Antwort unverändert liest), Fehler `{ \"error\", \"message\", \"status\", \"code\" }` (bei 422 zusätzlich `details`). Unbekannte Felder im\nBody → 422. Keine internen IDs in Antworten. Breaking Changes nur über `/api/site/v2`.\n\n## Medien\n\nBilder und Dateien aus dem CMS kommen als `MediaRef` mit **seitenrelativen, dauerhaften** URLs\n(`/_ds/media/<siteId>/<id>/<variante>.<endung>`). Sie werden vom selben Origin wie die Seite ausgeliefert (der\nEdge holt sie aus dem öffentlichen Medien-Speicher) — keine fremden Hosts, keine ablaufenden Links. Öffentlich wird\nnur, was im CMS veröffentlicht ist; nach dem Zurückziehen verschwinden die Dateien."
|
|
7
|
+
},
|
|
8
|
+
"servers": [
|
|
9
|
+
{
|
|
10
|
+
"url": "https://app.dealsystem.io/api/site/v1"
|
|
11
|
+
}
|
|
12
|
+
],
|
|
13
|
+
"tags": [
|
|
14
|
+
{
|
|
15
|
+
"name": "Site-API",
|
|
16
|
+
"description": "Formulare und Inhalte selbst gebauter Websites."
|
|
17
|
+
}
|
|
18
|
+
],
|
|
19
|
+
"paths": {
|
|
20
|
+
"/s/{key}/captcha": {
|
|
21
|
+
"get": {
|
|
22
|
+
"operationId": "getCaptchaChallenge",
|
|
23
|
+
"summary": "Captcha-Challenge holen",
|
|
24
|
+
"description": "Eigenes Proof-of-Work-Captcha (ALTCHA v3, selbst gehostet, kein Drittanbieter). Das ALTCHA-Widget (`altcha` 3.x) bekommt diesen Endpunkt als `challengeurl`, rechnet die Aufgabe (PBKDF2/SHA-256) im Browser und liefert den Payload `base64(JSON.stringify({ challenge, solution }))`, der als `captcha` in den Lead geht.\n\nDie Antwort ist die Challenge `{ parameters, signature }` selbst, ohne `{ data }`-Hülle — so liest das Widget sie. Gültig 10 Minuten; jede Lösung gilt einmal und nur für diese Seite. `Cache-Control: no-store`. Rate-Limit: 30/min je IP und Seite, 600/min je Seite.",
|
|
25
|
+
"tags": [
|
|
26
|
+
"Site-API"
|
|
27
|
+
],
|
|
28
|
+
"security": [],
|
|
29
|
+
"parameters": [
|
|
30
|
+
{
|
|
31
|
+
"name": "key",
|
|
32
|
+
"in": "path",
|
|
33
|
+
"required": true,
|
|
34
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
35
|
+
"schema": {
|
|
36
|
+
"type": "string",
|
|
37
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"name": "Origin",
|
|
42
|
+
"in": "header",
|
|
43
|
+
"required": true,
|
|
44
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
45
|
+
"schema": {
|
|
46
|
+
"type": "string"
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
],
|
|
50
|
+
"responses": {
|
|
51
|
+
"200": {
|
|
52
|
+
"description": "Challenge.",
|
|
53
|
+
"content": {
|
|
54
|
+
"application/json": {
|
|
55
|
+
"schema": {
|
|
56
|
+
"$ref": "#/components/schemas/CaptchaChallenge"
|
|
57
|
+
},
|
|
58
|
+
"example": {
|
|
59
|
+
"parameters": {
|
|
60
|
+
"algorithm": "PBKDF2/SHA-256",
|
|
61
|
+
"cost": 2000,
|
|
62
|
+
"data": {
|
|
63
|
+
"site": "2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a"
|
|
64
|
+
},
|
|
65
|
+
"expiresAt": 1794900000,
|
|
66
|
+
"keyLength": 32,
|
|
67
|
+
"keyPrefix": "a3cf01565f6bd0b9734372c424dd6ab5",
|
|
68
|
+
"keySignature": "c8cbd575181c5e8ddf4cd02d22e6445015b74b0aba282edfeb41eef17306182e",
|
|
69
|
+
"nonce": "ea5b13e06036e8d58e67103b61d0f6ac",
|
|
70
|
+
"salt": "2855d7c4023b51ce4c6faedc49a04bf5"
|
|
71
|
+
},
|
|
72
|
+
"signature": "cb04c40014e1c8ed691a0aad42415f1856cb3c279af6a8c662ba75aa732df6c9"
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
"204": {
|
|
78
|
+
"description": "Preflight (`OPTIONS`) für einen erlaubten `Origin`."
|
|
79
|
+
},
|
|
80
|
+
"403": {
|
|
81
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
82
|
+
"content": {
|
|
83
|
+
"application/json": {
|
|
84
|
+
"schema": {
|
|
85
|
+
"$ref": "#/components/schemas/Error"
|
|
86
|
+
},
|
|
87
|
+
"example": {
|
|
88
|
+
"error": "Forbidden",
|
|
89
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
90
|
+
"status": 403,
|
|
91
|
+
"code": "origin_not_allowed"
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
},
|
|
96
|
+
"404": {
|
|
97
|
+
"description": "`site_not_found`: Schlüssel unbekannt, abgelaufen, Seite gelöscht oder pausiert. `funnel_not_found` (nur Leads): Formular unbekannt oder ausgeschaltet.",
|
|
98
|
+
"content": {
|
|
99
|
+
"application/json": {
|
|
100
|
+
"schema": {
|
|
101
|
+
"$ref": "#/components/schemas/Error"
|
|
102
|
+
},
|
|
103
|
+
"example": {
|
|
104
|
+
"error": "Not Found",
|
|
105
|
+
"message": "Diese Website ist nicht (mehr) verfügbar.",
|
|
106
|
+
"status": 404,
|
|
107
|
+
"code": "site_not_found"
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
},
|
|
112
|
+
"429": {
|
|
113
|
+
"description": "`rate_limited`: zu viele Anfragen dieser IP an die Site-API (300/min, vor der Prüfung des Schlüssels) oder zu viele Challenges. Header `Retry-After` (Sekunden).",
|
|
114
|
+
"content": {
|
|
115
|
+
"application/json": {
|
|
116
|
+
"schema": {
|
|
117
|
+
"$ref": "#/components/schemas/Error"
|
|
118
|
+
},
|
|
119
|
+
"example": {
|
|
120
|
+
"error": "Too Many Requests",
|
|
121
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
122
|
+
"status": 429,
|
|
123
|
+
"code": "rate_limited"
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
"503": {
|
|
129
|
+
"description": "`captcha_unavailable`: Captcha auf unserer Seite nicht eingerichtet (kein Schlüssel).",
|
|
130
|
+
"content": {
|
|
131
|
+
"application/json": {
|
|
132
|
+
"schema": {
|
|
133
|
+
"$ref": "#/components/schemas/Error"
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
},
|
|
141
|
+
"/s/{key}/leads": {
|
|
142
|
+
"post": {
|
|
143
|
+
"operationId": "submitLead",
|
|
144
|
+
"summary": "Formular einreichen",
|
|
145
|
+
"description": "Legt aus einer Formular-Einsendung einen Lead im CRM an (Kontakt, Notiz mit den Antworten, je nach Einstellung Deal, Liste, Tags, Benachrichtigung). Ein vorhandener Kontakt (gleiche E-Mail-Adresse) wird nicht überschrieben, nur Leerstellen werden gefüllt. Aus der Vorschau (`<slug>--<token>.<SITES_DOMAIN>`) wird alles geprüft, aber nichts gespeichert (`dryRun: true`, 200).\n\nAblauf: Rate-Limit → Body lesen (höchstens 64 KB) → Honeypot → Body-Form → Captcha → Formular → Felder → Doppel-Einsendung (`submissionId`, 24 h) → Anlage.\n\n`Content-Type: application/json` ist Pflicht (sonst 415); er löst im Browser einen Preflight aus, den nur die Domains der Seite bestehen. Ohne Cookies aufrufen (`credentials: \"omit\"`).\n\nBei 429, 5xx und jedem Netzfehler zeigt das Formular Telefon und E-Mail aus den Firmendaten an.\n\n**Attribution** (`attribution`, optional): Fassung 2 (`v: 2`) oder die flache Fassung 1. `clickIds` speichert der Core nur mit `consent.marketing: true`, `visitorId` nur mit `consent.marketing: true`; sonst verwirft er sie vor dem Speichern. Query und Fragment in `landingPath` entfernt der Core. Für Pixel und gtag gilt die Ereignis-ID `lead-<submissionId>` (Deduplizierung mit der serverseitigen Conversion).",
|
|
146
|
+
"tags": [
|
|
147
|
+
"Site-API"
|
|
148
|
+
],
|
|
149
|
+
"security": [],
|
|
150
|
+
"parameters": [
|
|
151
|
+
{
|
|
152
|
+
"name": "key",
|
|
153
|
+
"in": "path",
|
|
154
|
+
"required": true,
|
|
155
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
156
|
+
"schema": {
|
|
157
|
+
"type": "string",
|
|
158
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"name": "Origin",
|
|
163
|
+
"in": "header",
|
|
164
|
+
"required": true,
|
|
165
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
166
|
+
"schema": {
|
|
167
|
+
"type": "string"
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
],
|
|
171
|
+
"requestBody": {
|
|
172
|
+
"required": true,
|
|
173
|
+
"content": {
|
|
174
|
+
"application/json": {
|
|
175
|
+
"schema": {
|
|
176
|
+
"type": "object",
|
|
177
|
+
"properties": {
|
|
178
|
+
"funnelKey": {
|
|
179
|
+
"type": "string",
|
|
180
|
+
"maxLength": 100,
|
|
181
|
+
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
|
|
182
|
+
"description": "Schlüssel des Formulars (kebab-case), wie im Code der Seite: `<LeadForm funnel=\"kontakt\">`."
|
|
183
|
+
},
|
|
184
|
+
"submissionId": {
|
|
185
|
+
"type": "string",
|
|
186
|
+
"format": "uuid",
|
|
187
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
188
|
+
"description": "Vom Client je Absendevorgang erzeugt. Dieselbe ID innerhalb von 24 h wird nur einmal angelegt und bekommt dieselbe Antwort."
|
|
189
|
+
},
|
|
190
|
+
"data": {
|
|
191
|
+
"type": "object",
|
|
192
|
+
"propertyNames": {
|
|
193
|
+
"type": "string",
|
|
194
|
+
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
|
|
195
|
+
},
|
|
196
|
+
"additionalProperties": {
|
|
197
|
+
"anyOf": [
|
|
198
|
+
{
|
|
199
|
+
"type": "string",
|
|
200
|
+
"maxLength": 10000
|
|
201
|
+
},
|
|
202
|
+
{
|
|
203
|
+
"type": "boolean"
|
|
204
|
+
},
|
|
205
|
+
{
|
|
206
|
+
"maxItems": 100,
|
|
207
|
+
"type": "array",
|
|
208
|
+
"items": {
|
|
209
|
+
"type": "string",
|
|
210
|
+
"maxLength": 500
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
]
|
|
214
|
+
},
|
|
215
|
+
"description": "Antworten je Feldname. Text, ja/nein (Checkbox) oder Liste (Mehrfachauswahl). Geprüft gegen die Felder, die der Build im Manifest gemeldet hat; unbekannte Felder landen nur in der Notiz, nie in Kontaktfeldern."
|
|
216
|
+
},
|
|
217
|
+
"attribution": {
|
|
218
|
+
"anyOf": [
|
|
219
|
+
{
|
|
220
|
+
"type": "object",
|
|
221
|
+
"properties": {
|
|
222
|
+
"v": {
|
|
223
|
+
"type": "number",
|
|
224
|
+
"const": 2
|
|
225
|
+
},
|
|
226
|
+
"first": {
|
|
227
|
+
"description": "Erster Besuch (First Touch).",
|
|
228
|
+
"anyOf": [
|
|
229
|
+
{
|
|
230
|
+
"type": "object",
|
|
231
|
+
"properties": {
|
|
232
|
+
"source": {
|
|
233
|
+
"anyOf": [
|
|
234
|
+
{
|
|
235
|
+
"type": "string",
|
|
236
|
+
"maxLength": 200
|
|
237
|
+
},
|
|
238
|
+
{
|
|
239
|
+
"type": "null"
|
|
240
|
+
}
|
|
241
|
+
]
|
|
242
|
+
},
|
|
243
|
+
"medium": {
|
|
244
|
+
"anyOf": [
|
|
245
|
+
{
|
|
246
|
+
"type": "string",
|
|
247
|
+
"maxLength": 200
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"type": "null"
|
|
251
|
+
}
|
|
252
|
+
]
|
|
253
|
+
},
|
|
254
|
+
"campaign": {
|
|
255
|
+
"anyOf": [
|
|
256
|
+
{
|
|
257
|
+
"type": "string",
|
|
258
|
+
"maxLength": 200
|
|
259
|
+
},
|
|
260
|
+
{
|
|
261
|
+
"type": "null"
|
|
262
|
+
}
|
|
263
|
+
]
|
|
264
|
+
},
|
|
265
|
+
"term": {
|
|
266
|
+
"anyOf": [
|
|
267
|
+
{
|
|
268
|
+
"type": "string",
|
|
269
|
+
"maxLength": 200
|
|
270
|
+
},
|
|
271
|
+
{
|
|
272
|
+
"type": "null"
|
|
273
|
+
}
|
|
274
|
+
]
|
|
275
|
+
},
|
|
276
|
+
"content": {
|
|
277
|
+
"anyOf": [
|
|
278
|
+
{
|
|
279
|
+
"type": "string",
|
|
280
|
+
"maxLength": 200
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"type": "null"
|
|
284
|
+
}
|
|
285
|
+
]
|
|
286
|
+
},
|
|
287
|
+
"referrerHost": {
|
|
288
|
+
"description": "Nur der Host, ohne Schema und Pfad.",
|
|
289
|
+
"anyOf": [
|
|
290
|
+
{
|
|
291
|
+
"type": "string",
|
|
292
|
+
"maxLength": 255
|
|
293
|
+
},
|
|
294
|
+
{
|
|
295
|
+
"type": "null"
|
|
296
|
+
}
|
|
297
|
+
]
|
|
298
|
+
},
|
|
299
|
+
"landingPath": {
|
|
300
|
+
"description": "Einstiegsseite (Pfad). Query und Fragment entfernt der Core vor dem Speichern.",
|
|
301
|
+
"anyOf": [
|
|
302
|
+
{
|
|
303
|
+
"type": "string",
|
|
304
|
+
"maxLength": 2000
|
|
305
|
+
},
|
|
306
|
+
{
|
|
307
|
+
"type": "null"
|
|
308
|
+
}
|
|
309
|
+
]
|
|
310
|
+
},
|
|
311
|
+
"at": {
|
|
312
|
+
"description": "Zeitpunkt des Besuchs (ISO 8601).",
|
|
313
|
+
"anyOf": [
|
|
314
|
+
{
|
|
315
|
+
"type": "string",
|
|
316
|
+
"maxLength": 64
|
|
317
|
+
},
|
|
318
|
+
{
|
|
319
|
+
"type": "null"
|
|
320
|
+
}
|
|
321
|
+
]
|
|
322
|
+
}
|
|
323
|
+
},
|
|
324
|
+
"additionalProperties": false
|
|
325
|
+
},
|
|
326
|
+
{
|
|
327
|
+
"type": "null"
|
|
328
|
+
}
|
|
329
|
+
]
|
|
330
|
+
},
|
|
331
|
+
"last": {
|
|
332
|
+
"description": "Letzter Besuch vor der Anfrage (Last Touch).",
|
|
333
|
+
"anyOf": [
|
|
334
|
+
{
|
|
335
|
+
"type": "object",
|
|
336
|
+
"properties": {
|
|
337
|
+
"source": {
|
|
338
|
+
"anyOf": [
|
|
339
|
+
{
|
|
340
|
+
"type": "string",
|
|
341
|
+
"maxLength": 200
|
|
342
|
+
},
|
|
343
|
+
{
|
|
344
|
+
"type": "null"
|
|
345
|
+
}
|
|
346
|
+
]
|
|
347
|
+
},
|
|
348
|
+
"medium": {
|
|
349
|
+
"anyOf": [
|
|
350
|
+
{
|
|
351
|
+
"type": "string",
|
|
352
|
+
"maxLength": 200
|
|
353
|
+
},
|
|
354
|
+
{
|
|
355
|
+
"type": "null"
|
|
356
|
+
}
|
|
357
|
+
]
|
|
358
|
+
},
|
|
359
|
+
"campaign": {
|
|
360
|
+
"anyOf": [
|
|
361
|
+
{
|
|
362
|
+
"type": "string",
|
|
363
|
+
"maxLength": 200
|
|
364
|
+
},
|
|
365
|
+
{
|
|
366
|
+
"type": "null"
|
|
367
|
+
}
|
|
368
|
+
]
|
|
369
|
+
},
|
|
370
|
+
"term": {
|
|
371
|
+
"anyOf": [
|
|
372
|
+
{
|
|
373
|
+
"type": "string",
|
|
374
|
+
"maxLength": 200
|
|
375
|
+
},
|
|
376
|
+
{
|
|
377
|
+
"type": "null"
|
|
378
|
+
}
|
|
379
|
+
]
|
|
380
|
+
},
|
|
381
|
+
"content": {
|
|
382
|
+
"anyOf": [
|
|
383
|
+
{
|
|
384
|
+
"type": "string",
|
|
385
|
+
"maxLength": 200
|
|
386
|
+
},
|
|
387
|
+
{
|
|
388
|
+
"type": "null"
|
|
389
|
+
}
|
|
390
|
+
]
|
|
391
|
+
},
|
|
392
|
+
"referrerHost": {
|
|
393
|
+
"description": "Nur der Host, ohne Schema und Pfad.",
|
|
394
|
+
"anyOf": [
|
|
395
|
+
{
|
|
396
|
+
"type": "string",
|
|
397
|
+
"maxLength": 255
|
|
398
|
+
},
|
|
399
|
+
{
|
|
400
|
+
"type": "null"
|
|
401
|
+
}
|
|
402
|
+
]
|
|
403
|
+
},
|
|
404
|
+
"landingPath": {
|
|
405
|
+
"description": "Einstiegsseite (Pfad). Query und Fragment entfernt der Core vor dem Speichern.",
|
|
406
|
+
"anyOf": [
|
|
407
|
+
{
|
|
408
|
+
"type": "string",
|
|
409
|
+
"maxLength": 2000
|
|
410
|
+
},
|
|
411
|
+
{
|
|
412
|
+
"type": "null"
|
|
413
|
+
}
|
|
414
|
+
]
|
|
415
|
+
},
|
|
416
|
+
"at": {
|
|
417
|
+
"description": "Zeitpunkt des Besuchs (ISO 8601).",
|
|
418
|
+
"anyOf": [
|
|
419
|
+
{
|
|
420
|
+
"type": "string",
|
|
421
|
+
"maxLength": 64
|
|
422
|
+
},
|
|
423
|
+
{
|
|
424
|
+
"type": "null"
|
|
425
|
+
}
|
|
426
|
+
]
|
|
427
|
+
}
|
|
428
|
+
},
|
|
429
|
+
"additionalProperties": false
|
|
430
|
+
},
|
|
431
|
+
{
|
|
432
|
+
"type": "null"
|
|
433
|
+
}
|
|
434
|
+
]
|
|
435
|
+
},
|
|
436
|
+
"touches": {
|
|
437
|
+
"description": "Anzahl der Besuche bis zur Anfrage.",
|
|
438
|
+
"anyOf": [
|
|
439
|
+
{
|
|
440
|
+
"type": "integer",
|
|
441
|
+
"minimum": 0,
|
|
442
|
+
"maximum": 1000
|
|
443
|
+
},
|
|
444
|
+
{
|
|
445
|
+
"type": "null"
|
|
446
|
+
}
|
|
447
|
+
]
|
|
448
|
+
},
|
|
449
|
+
"clickIds": {
|
|
450
|
+
"description": "Klick-IDs der Werbenetze. Nur mit `consent.marketing: true` gespeichert.",
|
|
451
|
+
"anyOf": [
|
|
452
|
+
{
|
|
453
|
+
"type": "object",
|
|
454
|
+
"properties": {
|
|
455
|
+
"gclid": {
|
|
456
|
+
"anyOf": [
|
|
457
|
+
{
|
|
458
|
+
"type": "string",
|
|
459
|
+
"maxLength": 500
|
|
460
|
+
},
|
|
461
|
+
{
|
|
462
|
+
"type": "null"
|
|
463
|
+
}
|
|
464
|
+
]
|
|
465
|
+
},
|
|
466
|
+
"gbraid": {
|
|
467
|
+
"anyOf": [
|
|
468
|
+
{
|
|
469
|
+
"type": "string",
|
|
470
|
+
"maxLength": 500
|
|
471
|
+
},
|
|
472
|
+
{
|
|
473
|
+
"type": "null"
|
|
474
|
+
}
|
|
475
|
+
]
|
|
476
|
+
},
|
|
477
|
+
"wbraid": {
|
|
478
|
+
"anyOf": [
|
|
479
|
+
{
|
|
480
|
+
"type": "string",
|
|
481
|
+
"maxLength": 500
|
|
482
|
+
},
|
|
483
|
+
{
|
|
484
|
+
"type": "null"
|
|
485
|
+
}
|
|
486
|
+
]
|
|
487
|
+
},
|
|
488
|
+
"fbc": {
|
|
489
|
+
"description": "Meta-Format `fb.1.<ms>.<fbclid>`.",
|
|
490
|
+
"anyOf": [
|
|
491
|
+
{
|
|
492
|
+
"type": "string",
|
|
493
|
+
"maxLength": 500
|
|
494
|
+
},
|
|
495
|
+
{
|
|
496
|
+
"type": "null"
|
|
497
|
+
}
|
|
498
|
+
]
|
|
499
|
+
},
|
|
500
|
+
"fbp": {
|
|
501
|
+
"description": "Wert des Pixel-Cookies `_fbp`.",
|
|
502
|
+
"anyOf": [
|
|
503
|
+
{
|
|
504
|
+
"type": "string",
|
|
505
|
+
"maxLength": 500
|
|
506
|
+
},
|
|
507
|
+
{
|
|
508
|
+
"type": "null"
|
|
509
|
+
}
|
|
510
|
+
]
|
|
511
|
+
},
|
|
512
|
+
"msclkid": {
|
|
513
|
+
"anyOf": [
|
|
514
|
+
{
|
|
515
|
+
"type": "string",
|
|
516
|
+
"maxLength": 500
|
|
517
|
+
},
|
|
518
|
+
{
|
|
519
|
+
"type": "null"
|
|
520
|
+
}
|
|
521
|
+
]
|
|
522
|
+
}
|
|
523
|
+
},
|
|
524
|
+
"additionalProperties": false
|
|
525
|
+
},
|
|
526
|
+
{
|
|
527
|
+
"type": "null"
|
|
528
|
+
}
|
|
529
|
+
]
|
|
530
|
+
},
|
|
531
|
+
"visitorId": {
|
|
532
|
+
"description": "Zufalls-UUID des Browsers. Nur mit `consent.marketing: true` gespeichert.",
|
|
533
|
+
"anyOf": [
|
|
534
|
+
{
|
|
535
|
+
"type": "string",
|
|
536
|
+
"format": "uuid",
|
|
537
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
|
|
538
|
+
},
|
|
539
|
+
{
|
|
540
|
+
"type": "null"
|
|
541
|
+
}
|
|
542
|
+
]
|
|
543
|
+
},
|
|
544
|
+
"params": {
|
|
545
|
+
"description": "Eigene URL-Parameter des aktuellen Besuchs (z. B. `partner`).",
|
|
546
|
+
"anyOf": [
|
|
547
|
+
{
|
|
548
|
+
"type": "object",
|
|
549
|
+
"propertyNames": {
|
|
550
|
+
"type": "string",
|
|
551
|
+
"pattern": "^[A-Za-z0-9_.-]{1,64}$"
|
|
552
|
+
},
|
|
553
|
+
"additionalProperties": {
|
|
554
|
+
"type": "string",
|
|
555
|
+
"maxLength": 500
|
|
556
|
+
}
|
|
557
|
+
},
|
|
558
|
+
{
|
|
559
|
+
"type": "null"
|
|
560
|
+
}
|
|
561
|
+
]
|
|
562
|
+
},
|
|
563
|
+
"consent": {
|
|
564
|
+
"type": "object",
|
|
565
|
+
"properties": {
|
|
566
|
+
"statistics": {
|
|
567
|
+
"type": "boolean"
|
|
568
|
+
},
|
|
569
|
+
"marketing": {
|
|
570
|
+
"type": "boolean"
|
|
571
|
+
},
|
|
572
|
+
"at": {
|
|
573
|
+
"description": "Zeitpunkt der Einwilligung (ISO 8601).",
|
|
574
|
+
"anyOf": [
|
|
575
|
+
{
|
|
576
|
+
"type": "string",
|
|
577
|
+
"maxLength": 64
|
|
578
|
+
},
|
|
579
|
+
{
|
|
580
|
+
"type": "null"
|
|
581
|
+
}
|
|
582
|
+
]
|
|
583
|
+
}
|
|
584
|
+
},
|
|
585
|
+
"required": [
|
|
586
|
+
"statistics",
|
|
587
|
+
"marketing"
|
|
588
|
+
],
|
|
589
|
+
"additionalProperties": false,
|
|
590
|
+
"description": "Einwilligung des Besuchers aus dem Cookie-Banner. `visitorId` und `clickIds` zählen nur mit `marketing: true` — sonst verwirft der Core sie vor dem Speichern."
|
|
591
|
+
}
|
|
592
|
+
},
|
|
593
|
+
"required": [
|
|
594
|
+
"v",
|
|
595
|
+
"consent"
|
|
596
|
+
],
|
|
597
|
+
"additionalProperties": false,
|
|
598
|
+
"description": "Fassung 2: First/Last Touch über Besuche, Klick-IDs, Besuchs-ID, Einwilligung."
|
|
599
|
+
},
|
|
600
|
+
{
|
|
601
|
+
"type": "object",
|
|
602
|
+
"properties": {
|
|
603
|
+
"utmSource": {
|
|
604
|
+
"type": "string",
|
|
605
|
+
"maxLength": 200
|
|
606
|
+
},
|
|
607
|
+
"utmMedium": {
|
|
608
|
+
"type": "string",
|
|
609
|
+
"maxLength": 200
|
|
610
|
+
},
|
|
611
|
+
"utmCampaign": {
|
|
612
|
+
"type": "string",
|
|
613
|
+
"maxLength": 200
|
|
614
|
+
},
|
|
615
|
+
"utmTerm": {
|
|
616
|
+
"type": "string",
|
|
617
|
+
"maxLength": 200
|
|
618
|
+
},
|
|
619
|
+
"utmContent": {
|
|
620
|
+
"type": "string",
|
|
621
|
+
"maxLength": 200
|
|
622
|
+
},
|
|
623
|
+
"referrerHost": {
|
|
624
|
+
"type": "string",
|
|
625
|
+
"maxLength": 255
|
|
626
|
+
},
|
|
627
|
+
"capturedAt": {
|
|
628
|
+
"type": "string",
|
|
629
|
+
"maxLength": 64
|
|
630
|
+
}
|
|
631
|
+
},
|
|
632
|
+
"additionalProperties": false,
|
|
633
|
+
"description": "Fassung 1 (flach, ältere SDKs): erster Kontaktpunkt des aktuellen Besuchs (UTM, Referrer). Wird weiter angenommen; gespeichert wie Fassung 2 ohne Einwilligung."
|
|
634
|
+
}
|
|
635
|
+
],
|
|
636
|
+
"description": "Herkunft des Leads. Optional. Fassung 2 (`v: 2`) oder die flache Fassung 1. Ohne Einwilligung hält das SDK nur den aktuellen Besuch im Arbeitsspeicher (TDDDG § 25)."
|
|
637
|
+
},
|
|
638
|
+
"captcha": {
|
|
639
|
+
"type": "string",
|
|
640
|
+
"minLength": 1,
|
|
641
|
+
"maxLength": 4000,
|
|
642
|
+
"description": "Lösung des Captchas (ALTCHA v3): base64 von `{ challenge, solution }` zu einer Challenge aus `GET …/captcha` — das ALTCHA-Widget im SDK liefert genau das. Gilt einmal, 10 Minuten, nur für diese Seite."
|
|
643
|
+
},
|
|
644
|
+
"website": {
|
|
645
|
+
"description": "Honeypot: unsichtbares Feld, bleibt leer. Ist es gefüllt, wird nichts gespeichert.",
|
|
646
|
+
"type": "string",
|
|
647
|
+
"maxLength": 500
|
|
648
|
+
}
|
|
649
|
+
},
|
|
650
|
+
"required": [
|
|
651
|
+
"funnelKey",
|
|
652
|
+
"submissionId",
|
|
653
|
+
"data",
|
|
654
|
+
"captcha"
|
|
655
|
+
],
|
|
656
|
+
"additionalProperties": false
|
|
657
|
+
},
|
|
658
|
+
"example": {
|
|
659
|
+
"funnelKey": "kontakt",
|
|
660
|
+
"submissionId": "0b7e3c9a-2f4d-4e8b-9a1c-5d6e7f8a9b0c",
|
|
661
|
+
"data": {
|
|
662
|
+
"firstName": "Erika",
|
|
663
|
+
"lastName": "Muster",
|
|
664
|
+
"email": "erika@example.de",
|
|
665
|
+
"nachricht": "Bitte um Rückruf."
|
|
666
|
+
},
|
|
667
|
+
"attribution": {
|
|
668
|
+
"v": 2,
|
|
669
|
+
"first": {
|
|
670
|
+
"source": "google",
|
|
671
|
+
"medium": "cpc",
|
|
672
|
+
"campaign": "herbst",
|
|
673
|
+
"referrerHost": "www.google.com",
|
|
674
|
+
"landingPath": "/verkaufen",
|
|
675
|
+
"at": "2026-11-10T08:03:00.000Z"
|
|
676
|
+
},
|
|
677
|
+
"last": {
|
|
678
|
+
"source": "newsletter",
|
|
679
|
+
"medium": "email",
|
|
680
|
+
"landingPath": "/",
|
|
681
|
+
"at": "2026-11-17T09:12:00.000Z"
|
|
682
|
+
},
|
|
683
|
+
"touches": 3,
|
|
684
|
+
"clickIds": {
|
|
685
|
+
"gclid": "EAIaIQobChMI-example",
|
|
686
|
+
"fbc": null,
|
|
687
|
+
"fbp": null,
|
|
688
|
+
"msclkid": null
|
|
689
|
+
},
|
|
690
|
+
"visitorId": "5b1d7c2e-8f4a-4e3b-9c6d-2a7f1e0b3c4d",
|
|
691
|
+
"params": {
|
|
692
|
+
"partner": "bank-west"
|
|
693
|
+
},
|
|
694
|
+
"consent": {
|
|
695
|
+
"statistics": true,
|
|
696
|
+
"marketing": true,
|
|
697
|
+
"at": "2026-11-10T08:03:05.000Z"
|
|
698
|
+
}
|
|
699
|
+
},
|
|
700
|
+
"captcha": "eyJhbGdvcml0aG0iOiJTSEEtMjU2IiwiY2hhbGxlbmdlIjoi4oCmIiwibnVtYmVyIjo0MjEzNywic2FsdCI6IuKApiIsInNpZ25hdHVyZSI6IuKApiJ9",
|
|
701
|
+
"website": ""
|
|
702
|
+
}
|
|
703
|
+
}
|
|
704
|
+
}
|
|
705
|
+
},
|
|
706
|
+
"responses": {
|
|
707
|
+
"200": {
|
|
708
|
+
"description": "Vorschau: geprüft, nichts gespeichert.",
|
|
709
|
+
"content": {
|
|
710
|
+
"application/json": {
|
|
711
|
+
"schema": {
|
|
712
|
+
"$ref": "#/components/schemas/LeadAccepted"
|
|
713
|
+
},
|
|
714
|
+
"example": {
|
|
715
|
+
"data": {
|
|
716
|
+
"accepted": true,
|
|
717
|
+
"dryRun": true
|
|
718
|
+
}
|
|
719
|
+
}
|
|
720
|
+
}
|
|
721
|
+
}
|
|
722
|
+
},
|
|
723
|
+
"201": {
|
|
724
|
+
"description": "Angenommen. Auch bei einer wiederholten `submissionId` (dieselbe Antwort, nichts doppelt) und bei gefülltem Honeypot.",
|
|
725
|
+
"content": {
|
|
726
|
+
"application/json": {
|
|
727
|
+
"schema": {
|
|
728
|
+
"$ref": "#/components/schemas/LeadAccepted"
|
|
729
|
+
},
|
|
730
|
+
"example": {
|
|
731
|
+
"data": {
|
|
732
|
+
"accepted": true
|
|
733
|
+
}
|
|
734
|
+
}
|
|
735
|
+
}
|
|
736
|
+
}
|
|
737
|
+
},
|
|
738
|
+
"204": {
|
|
739
|
+
"description": "Preflight (`OPTIONS`) für einen erlaubten `Origin`."
|
|
740
|
+
},
|
|
741
|
+
"400": {
|
|
742
|
+
"description": "`captcha_failed`: Lösung falsch, abgelaufen, schon benutzt oder von einer anderen Seite — neue Challenge holen. `invalid_json`: Body ist kein JSON.",
|
|
743
|
+
"content": {
|
|
744
|
+
"application/json": {
|
|
745
|
+
"schema": {
|
|
746
|
+
"$ref": "#/components/schemas/Error"
|
|
747
|
+
},
|
|
748
|
+
"example": {
|
|
749
|
+
"error": "Bad Request",
|
|
750
|
+
"message": "Die Sicherheitsprüfung ist fehlgeschlagen. Bitte erneut versuchen.",
|
|
751
|
+
"status": 400,
|
|
752
|
+
"code": "captcha_failed"
|
|
753
|
+
}
|
|
754
|
+
}
|
|
755
|
+
}
|
|
756
|
+
},
|
|
757
|
+
"403": {
|
|
758
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
759
|
+
"content": {
|
|
760
|
+
"application/json": {
|
|
761
|
+
"schema": {
|
|
762
|
+
"$ref": "#/components/schemas/Error"
|
|
763
|
+
},
|
|
764
|
+
"example": {
|
|
765
|
+
"error": "Forbidden",
|
|
766
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
767
|
+
"status": 403,
|
|
768
|
+
"code": "origin_not_allowed"
|
|
769
|
+
}
|
|
770
|
+
}
|
|
771
|
+
}
|
|
772
|
+
},
|
|
773
|
+
"404": {
|
|
774
|
+
"description": "`site_not_found`: Schlüssel unbekannt, abgelaufen, Seite gelöscht oder pausiert. `funnel_not_found` (nur Leads): Formular unbekannt oder ausgeschaltet.",
|
|
775
|
+
"content": {
|
|
776
|
+
"application/json": {
|
|
777
|
+
"schema": {
|
|
778
|
+
"$ref": "#/components/schemas/Error"
|
|
779
|
+
},
|
|
780
|
+
"example": {
|
|
781
|
+
"error": "Not Found",
|
|
782
|
+
"message": "Diese Website ist nicht (mehr) verfügbar.",
|
|
783
|
+
"status": 404,
|
|
784
|
+
"code": "site_not_found"
|
|
785
|
+
}
|
|
786
|
+
}
|
|
787
|
+
}
|
|
788
|
+
},
|
|
789
|
+
"405": {
|
|
790
|
+
"description": "`method_not_allowed`: nur `GET` und `POST`.",
|
|
791
|
+
"content": {
|
|
792
|
+
"application/json": {
|
|
793
|
+
"schema": {
|
|
794
|
+
"$ref": "#/components/schemas/Error"
|
|
795
|
+
}
|
|
796
|
+
}
|
|
797
|
+
}
|
|
798
|
+
},
|
|
799
|
+
"413": {
|
|
800
|
+
"description": "`payload_too_large`: Body größer als 64 KB (angekündigt per `Content-Length` oder beim Lesen erkannt). Gelesen wird erst nach dem Rate-Limit.",
|
|
801
|
+
"content": {
|
|
802
|
+
"application/json": {
|
|
803
|
+
"schema": {
|
|
804
|
+
"$ref": "#/components/schemas/Error"
|
|
805
|
+
},
|
|
806
|
+
"example": {
|
|
807
|
+
"error": "Payload Too Large",
|
|
808
|
+
"message": "Die Anfrage ist zu groß.",
|
|
809
|
+
"status": 413,
|
|
810
|
+
"code": "payload_too_large"
|
|
811
|
+
}
|
|
812
|
+
}
|
|
813
|
+
}
|
|
814
|
+
},
|
|
815
|
+
"415": {
|
|
816
|
+
"description": "`unsupported_media_type`: `Content-Type` ist nicht `application/json`.",
|
|
817
|
+
"content": {
|
|
818
|
+
"application/json": {
|
|
819
|
+
"schema": {
|
|
820
|
+
"$ref": "#/components/schemas/Error"
|
|
821
|
+
}
|
|
822
|
+
}
|
|
823
|
+
}
|
|
824
|
+
},
|
|
825
|
+
"422": {
|
|
826
|
+
"description": "`validation_error`: Body-Form (unbekanntes Feld, fehlende `submissionId` …) oder Felder gegen das Formular (Pflicht, Typ, Länge, Auswahl; E-Mail-Adresse oder Telefonnummer muss dabei sein). `details` nennt die Felder.",
|
|
827
|
+
"content": {
|
|
828
|
+
"application/json": {
|
|
829
|
+
"schema": {
|
|
830
|
+
"$ref": "#/components/schemas/Error"
|
|
831
|
+
},
|
|
832
|
+
"example": {
|
|
833
|
+
"error": "Validation Error",
|
|
834
|
+
"message": "data.email: Keine gültige E-Mail-Adresse.",
|
|
835
|
+
"status": 422,
|
|
836
|
+
"code": "validation_error",
|
|
837
|
+
"details": [
|
|
838
|
+
{
|
|
839
|
+
"path": "data.email",
|
|
840
|
+
"message": "Keine gültige E-Mail-Adresse."
|
|
841
|
+
}
|
|
842
|
+
]
|
|
843
|
+
}
|
|
844
|
+
}
|
|
845
|
+
}
|
|
846
|
+
},
|
|
847
|
+
"429": {
|
|
848
|
+
"description": "`rate_limited`: 300/min je IP über die ganze Site-API (vor der Prüfung des Schlüssels), dazu 5/min und 30/h je IP und Seite, 60/min und 1 000/Tag je Seite. Header `Retry-After` (Sekunden).",
|
|
849
|
+
"content": {
|
|
850
|
+
"application/json": {
|
|
851
|
+
"schema": {
|
|
852
|
+
"$ref": "#/components/schemas/Error"
|
|
853
|
+
},
|
|
854
|
+
"example": {
|
|
855
|
+
"error": "Too Many Requests",
|
|
856
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
857
|
+
"status": 429,
|
|
858
|
+
"code": "rate_limited"
|
|
859
|
+
}
|
|
860
|
+
}
|
|
861
|
+
}
|
|
862
|
+
},
|
|
863
|
+
"500": {
|
|
864
|
+
"description": "`internal_error`: Speichern gescheitert; dieselbe `submissionId` darf erneut gesendet werden.",
|
|
865
|
+
"content": {
|
|
866
|
+
"application/json": {
|
|
867
|
+
"schema": {
|
|
868
|
+
"$ref": "#/components/schemas/Error"
|
|
869
|
+
}
|
|
870
|
+
}
|
|
871
|
+
}
|
|
872
|
+
},
|
|
873
|
+
"503": {
|
|
874
|
+
"description": "`captcha_unavailable`: Captcha auf unserer Seite nicht eingerichtet (kein Schlüssel).",
|
|
875
|
+
"content": {
|
|
876
|
+
"application/json": {
|
|
877
|
+
"schema": {
|
|
878
|
+
"$ref": "#/components/schemas/Error"
|
|
879
|
+
}
|
|
880
|
+
}
|
|
881
|
+
}
|
|
882
|
+
}
|
|
883
|
+
}
|
|
884
|
+
}
|
|
885
|
+
},
|
|
886
|
+
"/s/{key}/track": {
|
|
887
|
+
"post": {
|
|
888
|
+
"operationId": "trackPageview",
|
|
889
|
+
"summary": "Seitenaufruf zählen",
|
|
890
|
+
"description": "Zählt einen Seitenaufruf für die Statistik der Website (Besuche, Seiten, Kanäle). Das SDK ruft ihn bei jedem Seitenwechsel auf, mit `landing: true` beim ersten Aufruf eines Besuchs; nur dann zählen `utm` und `referrerHost` (Kanal des Besuchs).\n\n**Datenschutz:** Ohne Einwilligung speichert der Core nur Pfad (ohne Query und Fragment), Kanal, Kampagne und einen täglich wechselnden Hash aus IP und User-Agent; die IP selbst nie. `visitorId` nur mit `consent.marketing: true`; damit verknüpft eine spätere Anfrage die Besuche mit dem Kontakt. Aus der Vorschau wird nichts gezählt (`dryRun`). Bots werden still verworfen (dieselbe Antwort).\n\nBody höchstens 4 KB. Fehler hier darf das SDK ignorieren — nie dem Besucher zeigen.",
|
|
891
|
+
"tags": [
|
|
892
|
+
"Site-API"
|
|
893
|
+
],
|
|
894
|
+
"security": [],
|
|
895
|
+
"parameters": [
|
|
896
|
+
{
|
|
897
|
+
"name": "key",
|
|
898
|
+
"in": "path",
|
|
899
|
+
"required": true,
|
|
900
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
901
|
+
"schema": {
|
|
902
|
+
"type": "string",
|
|
903
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
904
|
+
}
|
|
905
|
+
},
|
|
906
|
+
{
|
|
907
|
+
"name": "Origin",
|
|
908
|
+
"in": "header",
|
|
909
|
+
"required": true,
|
|
910
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
911
|
+
"schema": {
|
|
912
|
+
"type": "string"
|
|
913
|
+
}
|
|
914
|
+
}
|
|
915
|
+
],
|
|
916
|
+
"requestBody": {
|
|
917
|
+
"required": true,
|
|
918
|
+
"content": {
|
|
919
|
+
"application/json": {
|
|
920
|
+
"schema": {
|
|
921
|
+
"type": "object",
|
|
922
|
+
"properties": {
|
|
923
|
+
"path": {
|
|
924
|
+
"type": "string",
|
|
925
|
+
"minLength": 1,
|
|
926
|
+
"maxLength": 2000,
|
|
927
|
+
"pattern": "^\\/",
|
|
928
|
+
"description": "`location.pathname`. Query und Fragment entfernt der Core vor dem Speichern."
|
|
929
|
+
},
|
|
930
|
+
"landing": {
|
|
931
|
+
"description": "`true` beim ersten Seitenaufruf eines Besuchs (Einstieg). Nur dann zählen `utm` und `referrerHost`.",
|
|
932
|
+
"type": "boolean"
|
|
933
|
+
},
|
|
934
|
+
"referrerHost": {
|
|
935
|
+
"description": "Host von `document.referrer`, nur wenn fremd.",
|
|
936
|
+
"anyOf": [
|
|
937
|
+
{
|
|
938
|
+
"type": "string",
|
|
939
|
+
"maxLength": 255
|
|
940
|
+
},
|
|
941
|
+
{
|
|
942
|
+
"type": "null"
|
|
943
|
+
}
|
|
944
|
+
]
|
|
945
|
+
},
|
|
946
|
+
"utm": {
|
|
947
|
+
"description": "UTM-Parameter des aktuellen Besuchs.",
|
|
948
|
+
"anyOf": [
|
|
949
|
+
{
|
|
950
|
+
"type": "object",
|
|
951
|
+
"properties": {
|
|
952
|
+
"source": {
|
|
953
|
+
"anyOf": [
|
|
954
|
+
{
|
|
955
|
+
"type": "string",
|
|
956
|
+
"maxLength": 200
|
|
957
|
+
},
|
|
958
|
+
{
|
|
959
|
+
"type": "null"
|
|
960
|
+
}
|
|
961
|
+
]
|
|
962
|
+
},
|
|
963
|
+
"medium": {
|
|
964
|
+
"anyOf": [
|
|
965
|
+
{
|
|
966
|
+
"type": "string",
|
|
967
|
+
"maxLength": 200
|
|
968
|
+
},
|
|
969
|
+
{
|
|
970
|
+
"type": "null"
|
|
971
|
+
}
|
|
972
|
+
]
|
|
973
|
+
},
|
|
974
|
+
"campaign": {
|
|
975
|
+
"anyOf": [
|
|
976
|
+
{
|
|
977
|
+
"type": "string",
|
|
978
|
+
"maxLength": 200
|
|
979
|
+
},
|
|
980
|
+
{
|
|
981
|
+
"type": "null"
|
|
982
|
+
}
|
|
983
|
+
]
|
|
984
|
+
},
|
|
985
|
+
"term": {
|
|
986
|
+
"anyOf": [
|
|
987
|
+
{
|
|
988
|
+
"type": "string",
|
|
989
|
+
"maxLength": 200
|
|
990
|
+
},
|
|
991
|
+
{
|
|
992
|
+
"type": "null"
|
|
993
|
+
}
|
|
994
|
+
]
|
|
995
|
+
},
|
|
996
|
+
"content": {
|
|
997
|
+
"anyOf": [
|
|
998
|
+
{
|
|
999
|
+
"type": "string",
|
|
1000
|
+
"maxLength": 200
|
|
1001
|
+
},
|
|
1002
|
+
{
|
|
1003
|
+
"type": "null"
|
|
1004
|
+
}
|
|
1005
|
+
]
|
|
1006
|
+
}
|
|
1007
|
+
},
|
|
1008
|
+
"additionalProperties": false
|
|
1009
|
+
},
|
|
1010
|
+
{
|
|
1011
|
+
"type": "null"
|
|
1012
|
+
}
|
|
1013
|
+
]
|
|
1014
|
+
},
|
|
1015
|
+
"visitorId": {
|
|
1016
|
+
"description": "Nur mit `consent.marketing: true` gespeichert.",
|
|
1017
|
+
"anyOf": [
|
|
1018
|
+
{
|
|
1019
|
+
"type": "string",
|
|
1020
|
+
"format": "uuid",
|
|
1021
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
|
|
1022
|
+
},
|
|
1023
|
+
{
|
|
1024
|
+
"type": "null"
|
|
1025
|
+
}
|
|
1026
|
+
]
|
|
1027
|
+
},
|
|
1028
|
+
"consent": {
|
|
1029
|
+
"description": "Fehlt = keine Einwilligung.",
|
|
1030
|
+
"type": "object",
|
|
1031
|
+
"properties": {
|
|
1032
|
+
"statistics": {
|
|
1033
|
+
"type": "boolean"
|
|
1034
|
+
},
|
|
1035
|
+
"marketing": {
|
|
1036
|
+
"type": "boolean"
|
|
1037
|
+
},
|
|
1038
|
+
"at": {
|
|
1039
|
+
"description": "Zeitpunkt der Einwilligung (ISO 8601).",
|
|
1040
|
+
"anyOf": [
|
|
1041
|
+
{
|
|
1042
|
+
"type": "string",
|
|
1043
|
+
"maxLength": 64
|
|
1044
|
+
},
|
|
1045
|
+
{
|
|
1046
|
+
"type": "null"
|
|
1047
|
+
}
|
|
1048
|
+
]
|
|
1049
|
+
}
|
|
1050
|
+
},
|
|
1051
|
+
"required": [
|
|
1052
|
+
"statistics",
|
|
1053
|
+
"marketing"
|
|
1054
|
+
],
|
|
1055
|
+
"additionalProperties": false
|
|
1056
|
+
}
|
|
1057
|
+
},
|
|
1058
|
+
"required": [
|
|
1059
|
+
"path"
|
|
1060
|
+
],
|
|
1061
|
+
"additionalProperties": false
|
|
1062
|
+
},
|
|
1063
|
+
"example": {
|
|
1064
|
+
"path": "/verkaufen",
|
|
1065
|
+
"landing": true,
|
|
1066
|
+
"referrerHost": "www.google.com",
|
|
1067
|
+
"utm": {
|
|
1068
|
+
"source": "google",
|
|
1069
|
+
"medium": "cpc",
|
|
1070
|
+
"campaign": "herbst"
|
|
1071
|
+
},
|
|
1072
|
+
"visitorId": "5b1d7c2e-8f4a-4e3b-9c6d-2a7f1e0b3c4d",
|
|
1073
|
+
"consent": {
|
|
1074
|
+
"statistics": false,
|
|
1075
|
+
"marketing": true,
|
|
1076
|
+
"at": "2026-11-10T08:03:05.000Z"
|
|
1077
|
+
}
|
|
1078
|
+
}
|
|
1079
|
+
}
|
|
1080
|
+
}
|
|
1081
|
+
},
|
|
1082
|
+
"responses": {
|
|
1083
|
+
"200": {
|
|
1084
|
+
"description": "Vorschau: geprüft, nichts gezählt.",
|
|
1085
|
+
"content": {
|
|
1086
|
+
"application/json": {
|
|
1087
|
+
"schema": {
|
|
1088
|
+
"$ref": "#/components/schemas/PageviewAccepted"
|
|
1089
|
+
},
|
|
1090
|
+
"example": {
|
|
1091
|
+
"data": {
|
|
1092
|
+
"accepted": true,
|
|
1093
|
+
"dryRun": true
|
|
1094
|
+
}
|
|
1095
|
+
}
|
|
1096
|
+
}
|
|
1097
|
+
}
|
|
1098
|
+
},
|
|
1099
|
+
"202": {
|
|
1100
|
+
"description": "Gezählt (oder als Bot verworfen).",
|
|
1101
|
+
"content": {
|
|
1102
|
+
"application/json": {
|
|
1103
|
+
"schema": {
|
|
1104
|
+
"$ref": "#/components/schemas/PageviewAccepted"
|
|
1105
|
+
},
|
|
1106
|
+
"example": {
|
|
1107
|
+
"data": {
|
|
1108
|
+
"accepted": true
|
|
1109
|
+
}
|
|
1110
|
+
}
|
|
1111
|
+
}
|
|
1112
|
+
}
|
|
1113
|
+
},
|
|
1114
|
+
"204": {
|
|
1115
|
+
"description": "Preflight (`OPTIONS`) für einen erlaubten `Origin`."
|
|
1116
|
+
},
|
|
1117
|
+
"400": {
|
|
1118
|
+
"description": "`invalid_json`: Body ist kein JSON.",
|
|
1119
|
+
"content": {
|
|
1120
|
+
"application/json": {
|
|
1121
|
+
"schema": {
|
|
1122
|
+
"$ref": "#/components/schemas/Error"
|
|
1123
|
+
}
|
|
1124
|
+
}
|
|
1125
|
+
}
|
|
1126
|
+
},
|
|
1127
|
+
"403": {
|
|
1128
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
1129
|
+
"content": {
|
|
1130
|
+
"application/json": {
|
|
1131
|
+
"schema": {
|
|
1132
|
+
"$ref": "#/components/schemas/Error"
|
|
1133
|
+
},
|
|
1134
|
+
"example": {
|
|
1135
|
+
"error": "Forbidden",
|
|
1136
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
1137
|
+
"status": 403,
|
|
1138
|
+
"code": "origin_not_allowed"
|
|
1139
|
+
}
|
|
1140
|
+
}
|
|
1141
|
+
}
|
|
1142
|
+
},
|
|
1143
|
+
"404": {
|
|
1144
|
+
"description": "`site_not_found`: Schlüssel unbekannt, abgelaufen, Seite gelöscht oder pausiert. `funnel_not_found` (nur Leads): Formular unbekannt oder ausgeschaltet.",
|
|
1145
|
+
"content": {
|
|
1146
|
+
"application/json": {
|
|
1147
|
+
"schema": {
|
|
1148
|
+
"$ref": "#/components/schemas/Error"
|
|
1149
|
+
},
|
|
1150
|
+
"example": {
|
|
1151
|
+
"error": "Not Found",
|
|
1152
|
+
"message": "Diese Website ist nicht (mehr) verfügbar.",
|
|
1153
|
+
"status": 404,
|
|
1154
|
+
"code": "site_not_found"
|
|
1155
|
+
}
|
|
1156
|
+
}
|
|
1157
|
+
}
|
|
1158
|
+
},
|
|
1159
|
+
"405": {
|
|
1160
|
+
"description": "`method_not_allowed`: nur `GET` und `POST`.",
|
|
1161
|
+
"content": {
|
|
1162
|
+
"application/json": {
|
|
1163
|
+
"schema": {
|
|
1164
|
+
"$ref": "#/components/schemas/Error"
|
|
1165
|
+
}
|
|
1166
|
+
}
|
|
1167
|
+
}
|
|
1168
|
+
},
|
|
1169
|
+
"413": {
|
|
1170
|
+
"description": "`payload_too_large`: Body größer als 4 KB. Gelesen wird erst nach dem Rate-Limit.",
|
|
1171
|
+
"content": {
|
|
1172
|
+
"application/json": {
|
|
1173
|
+
"schema": {
|
|
1174
|
+
"$ref": "#/components/schemas/Error"
|
|
1175
|
+
},
|
|
1176
|
+
"example": {
|
|
1177
|
+
"error": "Payload Too Large",
|
|
1178
|
+
"message": "Die Anfrage ist zu groß.",
|
|
1179
|
+
"status": 413,
|
|
1180
|
+
"code": "payload_too_large"
|
|
1181
|
+
}
|
|
1182
|
+
}
|
|
1183
|
+
}
|
|
1184
|
+
},
|
|
1185
|
+
"415": {
|
|
1186
|
+
"description": "`unsupported_media_type`: `Content-Type` ist nicht `application/json`.",
|
|
1187
|
+
"content": {
|
|
1188
|
+
"application/json": {
|
|
1189
|
+
"schema": {
|
|
1190
|
+
"$ref": "#/components/schemas/Error"
|
|
1191
|
+
}
|
|
1192
|
+
}
|
|
1193
|
+
}
|
|
1194
|
+
},
|
|
1195
|
+
"422": {
|
|
1196
|
+
"description": "`validation_error`: unbekanntes Feld, Pfad ohne führendes `/`, ungültige `visitorId` …",
|
|
1197
|
+
"content": {
|
|
1198
|
+
"application/json": {
|
|
1199
|
+
"schema": {
|
|
1200
|
+
"$ref": "#/components/schemas/Error"
|
|
1201
|
+
},
|
|
1202
|
+
"example": {
|
|
1203
|
+
"error": "Validation Error",
|
|
1204
|
+
"message": "path: Pfad muss mit / beginnen.",
|
|
1205
|
+
"status": 422,
|
|
1206
|
+
"code": "validation_error",
|
|
1207
|
+
"details": [
|
|
1208
|
+
{
|
|
1209
|
+
"path": "path",
|
|
1210
|
+
"message": "Pfad muss mit / beginnen."
|
|
1211
|
+
}
|
|
1212
|
+
]
|
|
1213
|
+
}
|
|
1214
|
+
}
|
|
1215
|
+
}
|
|
1216
|
+
},
|
|
1217
|
+
"429": {
|
|
1218
|
+
"description": "`rate_limited`: 300/min je IP über die ganze Site-API, dazu 60/min je IP und Seite, 1 200/min und 50 000/Tag je Seite. Header `Retry-After` (Sekunden).",
|
|
1219
|
+
"content": {
|
|
1220
|
+
"application/json": {
|
|
1221
|
+
"schema": {
|
|
1222
|
+
"$ref": "#/components/schemas/Error"
|
|
1223
|
+
},
|
|
1224
|
+
"example": {
|
|
1225
|
+
"error": "Too Many Requests",
|
|
1226
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
1227
|
+
"status": 429,
|
|
1228
|
+
"code": "rate_limited"
|
|
1229
|
+
}
|
|
1230
|
+
}
|
|
1231
|
+
}
|
|
1232
|
+
},
|
|
1233
|
+
"500": {
|
|
1234
|
+
"description": "`internal_error`: Speichern gescheitert.",
|
|
1235
|
+
"content": {
|
|
1236
|
+
"application/json": {
|
|
1237
|
+
"schema": {
|
|
1238
|
+
"$ref": "#/components/schemas/Error"
|
|
1239
|
+
}
|
|
1240
|
+
}
|
|
1241
|
+
}
|
|
1242
|
+
}
|
|
1243
|
+
}
|
|
1244
|
+
}
|
|
1245
|
+
},
|
|
1246
|
+
"/s/{key}/collections/{collection}": {
|
|
1247
|
+
"get": {
|
|
1248
|
+
"operationId": "listCollection",
|
|
1249
|
+
"summary": "Einträge einer Sammlung",
|
|
1250
|
+
"description": "Veröffentlichte Einträge einer Sammlung der Seite (Schlüssel wie in `dealsystem.config.ts`), mit Medien. Entwürfe kommen nie vor. Gedacht für Seiten, die Inhalte zur Laufzeit nachladen; beim Build liest das SDK den Inhalts-Schnappschuss (gleiche Form je Eintrag).\n\nAbfrage: `limit` 1–100 (Standard 20), `offset` 0–10000, `sort` `-publishedAt` (Standard, neueste zuerst) oder `publishedAt`. Werte außerhalb werden auf die Grenzen gesetzt, ein unbekanntes `sort` gilt als Standard; `meta` nennt die angewandten Werte.\n\n`Cache-Control: public, max-age=60, stale-while-revalidate=300` und `ETag`; mit `If-None-Match` → 304. Rate-Limit: 120/min je IP und Seite, 3 000/min je Seite.",
|
|
1251
|
+
"tags": [
|
|
1252
|
+
"Site-API"
|
|
1253
|
+
],
|
|
1254
|
+
"security": [],
|
|
1255
|
+
"parameters": [
|
|
1256
|
+
{
|
|
1257
|
+
"name": "key",
|
|
1258
|
+
"in": "path",
|
|
1259
|
+
"required": true,
|
|
1260
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
1261
|
+
"schema": {
|
|
1262
|
+
"type": "string",
|
|
1263
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
1264
|
+
}
|
|
1265
|
+
},
|
|
1266
|
+
{
|
|
1267
|
+
"name": "Origin",
|
|
1268
|
+
"in": "header",
|
|
1269
|
+
"required": true,
|
|
1270
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
1271
|
+
"schema": {
|
|
1272
|
+
"type": "string"
|
|
1273
|
+
}
|
|
1274
|
+
},
|
|
1275
|
+
{
|
|
1276
|
+
"name": "collection",
|
|
1277
|
+
"in": "path",
|
|
1278
|
+
"required": true,
|
|
1279
|
+
"description": "Schlüssel der Sammlung.",
|
|
1280
|
+
"schema": {
|
|
1281
|
+
"type": "string",
|
|
1282
|
+
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
|
|
1283
|
+
"maxLength": 100
|
|
1284
|
+
}
|
|
1285
|
+
},
|
|
1286
|
+
{
|
|
1287
|
+
"name": "limit",
|
|
1288
|
+
"in": "query",
|
|
1289
|
+
"required": false,
|
|
1290
|
+
"schema": {
|
|
1291
|
+
"type": "integer",
|
|
1292
|
+
"minimum": 1,
|
|
1293
|
+
"maximum": 100,
|
|
1294
|
+
"default": 20
|
|
1295
|
+
}
|
|
1296
|
+
},
|
|
1297
|
+
{
|
|
1298
|
+
"name": "offset",
|
|
1299
|
+
"in": "query",
|
|
1300
|
+
"required": false,
|
|
1301
|
+
"schema": {
|
|
1302
|
+
"type": "integer",
|
|
1303
|
+
"minimum": 0,
|
|
1304
|
+
"maximum": 10000,
|
|
1305
|
+
"default": 0
|
|
1306
|
+
}
|
|
1307
|
+
},
|
|
1308
|
+
{
|
|
1309
|
+
"name": "sort",
|
|
1310
|
+
"in": "query",
|
|
1311
|
+
"required": false,
|
|
1312
|
+
"schema": {
|
|
1313
|
+
"type": "string",
|
|
1314
|
+
"enum": [
|
|
1315
|
+
"-publishedAt",
|
|
1316
|
+
"publishedAt"
|
|
1317
|
+
],
|
|
1318
|
+
"default": "-publishedAt"
|
|
1319
|
+
}
|
|
1320
|
+
}
|
|
1321
|
+
],
|
|
1322
|
+
"responses": {
|
|
1323
|
+
"200": {
|
|
1324
|
+
"description": "Einträge.",
|
|
1325
|
+
"content": {
|
|
1326
|
+
"application/json": {
|
|
1327
|
+
"schema": {
|
|
1328
|
+
"$ref": "#/components/schemas/CollectionList"
|
|
1329
|
+
},
|
|
1330
|
+
"example": {
|
|
1331
|
+
"data": [
|
|
1332
|
+
{
|
|
1333
|
+
"slug": "altbau-leipzig",
|
|
1334
|
+
"publishedAt": "2026-11-01T09:00:00.000Z",
|
|
1335
|
+
"data": {
|
|
1336
|
+
"titel": "Sanierter Altbau",
|
|
1337
|
+
"beschreibung": "<p><strong>Drei</strong> Zimmer</p>"
|
|
1338
|
+
},
|
|
1339
|
+
"media": {
|
|
1340
|
+
"bilder": [
|
|
1341
|
+
{
|
|
1342
|
+
"id": "7b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
|
|
1343
|
+
"kind": "image",
|
|
1344
|
+
"alt": "Fassade des Altbaus",
|
|
1345
|
+
"width": 1600,
|
|
1346
|
+
"height": 1067,
|
|
1347
|
+
"variants": [
|
|
1348
|
+
{
|
|
1349
|
+
"url": "/_ds/media/2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a/7b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d/thumb.jpg",
|
|
1350
|
+
"width": 400,
|
|
1351
|
+
"format": "jpeg"
|
|
1352
|
+
},
|
|
1353
|
+
{
|
|
1354
|
+
"url": "/_ds/media/2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a/7b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d/medium.jpg",
|
|
1355
|
+
"width": 800,
|
|
1356
|
+
"format": "jpeg"
|
|
1357
|
+
},
|
|
1358
|
+
{
|
|
1359
|
+
"url": "/_ds/media/2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a/7b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d/large.jpg",
|
|
1360
|
+
"width": 1600,
|
|
1361
|
+
"format": "jpeg"
|
|
1362
|
+
}
|
|
1363
|
+
]
|
|
1364
|
+
}
|
|
1365
|
+
]
|
|
1366
|
+
}
|
|
1367
|
+
}
|
|
1368
|
+
],
|
|
1369
|
+
"meta": {
|
|
1370
|
+
"total": 1,
|
|
1371
|
+
"limit": 20,
|
|
1372
|
+
"offset": 0
|
|
1373
|
+
}
|
|
1374
|
+
}
|
|
1375
|
+
}
|
|
1376
|
+
}
|
|
1377
|
+
},
|
|
1378
|
+
"204": {
|
|
1379
|
+
"description": "Preflight (`OPTIONS`) für einen erlaubten `Origin`."
|
|
1380
|
+
},
|
|
1381
|
+
"304": {
|
|
1382
|
+
"description": "Unverändert (`If-None-Match` passt zum `ETag`)."
|
|
1383
|
+
},
|
|
1384
|
+
"403": {
|
|
1385
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
1386
|
+
"content": {
|
|
1387
|
+
"application/json": {
|
|
1388
|
+
"schema": {
|
|
1389
|
+
"$ref": "#/components/schemas/Error"
|
|
1390
|
+
},
|
|
1391
|
+
"example": {
|
|
1392
|
+
"error": "Forbidden",
|
|
1393
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
1394
|
+
"status": 403,
|
|
1395
|
+
"code": "origin_not_allowed"
|
|
1396
|
+
}
|
|
1397
|
+
}
|
|
1398
|
+
}
|
|
1399
|
+
},
|
|
1400
|
+
"404": {
|
|
1401
|
+
"description": "`site_not_found`: Schlüssel unbekannt, abgelaufen, Seite gelöscht oder pausiert. `not_found`: Die Seite liest diese Sammlung nicht (laut letztem Build).",
|
|
1402
|
+
"content": {
|
|
1403
|
+
"application/json": {
|
|
1404
|
+
"schema": {
|
|
1405
|
+
"$ref": "#/components/schemas/Error"
|
|
1406
|
+
},
|
|
1407
|
+
"example": {
|
|
1408
|
+
"error": "Not Found",
|
|
1409
|
+
"message": "Nicht gefunden.",
|
|
1410
|
+
"status": 404,
|
|
1411
|
+
"code": "not_found"
|
|
1412
|
+
}
|
|
1413
|
+
}
|
|
1414
|
+
}
|
|
1415
|
+
},
|
|
1416
|
+
"405": {
|
|
1417
|
+
"description": "`method_not_allowed`: nur `GET`.",
|
|
1418
|
+
"content": {
|
|
1419
|
+
"application/json": {
|
|
1420
|
+
"schema": {
|
|
1421
|
+
"$ref": "#/components/schemas/Error"
|
|
1422
|
+
}
|
|
1423
|
+
}
|
|
1424
|
+
}
|
|
1425
|
+
},
|
|
1426
|
+
"429": {
|
|
1427
|
+
"description": "`rate_limited`: 120/min je IP und Seite, 3 000/min je Seite, dazu 300/min je IP über die ganze Site-API. Header `Retry-After` (Sekunden).",
|
|
1428
|
+
"content": {
|
|
1429
|
+
"application/json": {
|
|
1430
|
+
"schema": {
|
|
1431
|
+
"$ref": "#/components/schemas/Error"
|
|
1432
|
+
},
|
|
1433
|
+
"example": {
|
|
1434
|
+
"error": "Too Many Requests",
|
|
1435
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
1436
|
+
"status": 429,
|
|
1437
|
+
"code": "rate_limited"
|
|
1438
|
+
}
|
|
1439
|
+
}
|
|
1440
|
+
}
|
|
1441
|
+
}
|
|
1442
|
+
}
|
|
1443
|
+
}
|
|
1444
|
+
},
|
|
1445
|
+
"/s/{key}/collections/{collection}/{slug}": {
|
|
1446
|
+
"get": {
|
|
1447
|
+
"operationId": "getCollectionEntry",
|
|
1448
|
+
"summary": "Ein Eintrag einer Sammlung",
|
|
1449
|
+
"description": "Ein veröffentlichter Eintrag mit Medien. Ein Entwurf oder ein zurückgezogener Eintrag ergibt 404 `not_found`. Caching und Rate-Limit wie bei der Liste.",
|
|
1450
|
+
"tags": [
|
|
1451
|
+
"Site-API"
|
|
1452
|
+
],
|
|
1453
|
+
"security": [],
|
|
1454
|
+
"parameters": [
|
|
1455
|
+
{
|
|
1456
|
+
"name": "key",
|
|
1457
|
+
"in": "path",
|
|
1458
|
+
"required": true,
|
|
1459
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
1460
|
+
"schema": {
|
|
1461
|
+
"type": "string",
|
|
1462
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
1463
|
+
}
|
|
1464
|
+
},
|
|
1465
|
+
{
|
|
1466
|
+
"name": "Origin",
|
|
1467
|
+
"in": "header",
|
|
1468
|
+
"required": true,
|
|
1469
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
1470
|
+
"schema": {
|
|
1471
|
+
"type": "string"
|
|
1472
|
+
}
|
|
1473
|
+
},
|
|
1474
|
+
{
|
|
1475
|
+
"name": "collection",
|
|
1476
|
+
"in": "path",
|
|
1477
|
+
"required": true,
|
|
1478
|
+
"description": "Schlüssel der Sammlung.",
|
|
1479
|
+
"schema": {
|
|
1480
|
+
"type": "string",
|
|
1481
|
+
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
|
|
1482
|
+
"maxLength": 100
|
|
1483
|
+
}
|
|
1484
|
+
},
|
|
1485
|
+
{
|
|
1486
|
+
"name": "slug",
|
|
1487
|
+
"in": "path",
|
|
1488
|
+
"required": true,
|
|
1489
|
+
"description": "Slug des Eintrags (ab der ersten Veröffentlichung unveränderlich).",
|
|
1490
|
+
"schema": {
|
|
1491
|
+
"type": "string",
|
|
1492
|
+
"maxLength": 200
|
|
1493
|
+
}
|
|
1494
|
+
}
|
|
1495
|
+
],
|
|
1496
|
+
"responses": {
|
|
1497
|
+
"200": {
|
|
1498
|
+
"description": "Eintrag.",
|
|
1499
|
+
"content": {
|
|
1500
|
+
"application/json": {
|
|
1501
|
+
"schema": {
|
|
1502
|
+
"$ref": "#/components/schemas/CollectionEntry"
|
|
1503
|
+
},
|
|
1504
|
+
"example": {
|
|
1505
|
+
"data": {
|
|
1506
|
+
"slug": "altbau-leipzig",
|
|
1507
|
+
"publishedAt": "2026-11-01T09:00:00.000Z",
|
|
1508
|
+
"data": {
|
|
1509
|
+
"titel": "Sanierter Altbau"
|
|
1510
|
+
},
|
|
1511
|
+
"media": {
|
|
1512
|
+
"bilder": []
|
|
1513
|
+
}
|
|
1514
|
+
}
|
|
1515
|
+
}
|
|
1516
|
+
}
|
|
1517
|
+
}
|
|
1518
|
+
},
|
|
1519
|
+
"204": {
|
|
1520
|
+
"description": "Preflight (`OPTIONS`) für einen erlaubten `Origin`."
|
|
1521
|
+
},
|
|
1522
|
+
"304": {
|
|
1523
|
+
"description": "Unverändert (`If-None-Match` passt zum `ETag`)."
|
|
1524
|
+
},
|
|
1525
|
+
"403": {
|
|
1526
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
1527
|
+
"content": {
|
|
1528
|
+
"application/json": {
|
|
1529
|
+
"schema": {
|
|
1530
|
+
"$ref": "#/components/schemas/Error"
|
|
1531
|
+
},
|
|
1532
|
+
"example": {
|
|
1533
|
+
"error": "Forbidden",
|
|
1534
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
1535
|
+
"status": 403,
|
|
1536
|
+
"code": "origin_not_allowed"
|
|
1537
|
+
}
|
|
1538
|
+
}
|
|
1539
|
+
}
|
|
1540
|
+
},
|
|
1541
|
+
"404": {
|
|
1542
|
+
"description": "`site_not_found`: Schlüssel unbekannt, abgelaufen, Seite gelöscht oder pausiert. `not_found`: Sammlung oder veröffentlichter Eintrag gibt es nicht.",
|
|
1543
|
+
"content": {
|
|
1544
|
+
"application/json": {
|
|
1545
|
+
"schema": {
|
|
1546
|
+
"$ref": "#/components/schemas/Error"
|
|
1547
|
+
},
|
|
1548
|
+
"example": {
|
|
1549
|
+
"error": "Not Found",
|
|
1550
|
+
"message": "Nicht gefunden.",
|
|
1551
|
+
"status": 404,
|
|
1552
|
+
"code": "not_found"
|
|
1553
|
+
}
|
|
1554
|
+
}
|
|
1555
|
+
}
|
|
1556
|
+
},
|
|
1557
|
+
"405": {
|
|
1558
|
+
"description": "`method_not_allowed`: nur `GET`.",
|
|
1559
|
+
"content": {
|
|
1560
|
+
"application/json": {
|
|
1561
|
+
"schema": {
|
|
1562
|
+
"$ref": "#/components/schemas/Error"
|
|
1563
|
+
}
|
|
1564
|
+
}
|
|
1565
|
+
}
|
|
1566
|
+
},
|
|
1567
|
+
"429": {
|
|
1568
|
+
"description": "`rate_limited`: wie bei der Liste. Header `Retry-After` (Sekunden).",
|
|
1569
|
+
"content": {
|
|
1570
|
+
"application/json": {
|
|
1571
|
+
"schema": {
|
|
1572
|
+
"$ref": "#/components/schemas/Error"
|
|
1573
|
+
},
|
|
1574
|
+
"example": {
|
|
1575
|
+
"error": "Too Many Requests",
|
|
1576
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
1577
|
+
"status": 429,
|
|
1578
|
+
"code": "rate_limited"
|
|
1579
|
+
}
|
|
1580
|
+
}
|
|
1581
|
+
}
|
|
1582
|
+
}
|
|
1583
|
+
}
|
|
1584
|
+
}
|
|
1585
|
+
},
|
|
1586
|
+
"/s/{key}/booking/{bookingKey}": {
|
|
1587
|
+
"get": {
|
|
1588
|
+
"operationId": "getBooking",
|
|
1589
|
+
"summary": "Terminart einer Buchung",
|
|
1590
|
+
"description": "Titel, Dauer, Ort-Arten (ohne Adressen), Buchungsfragen und die Zeitzone des Kalenders. Rate-Limit 60/min je IP und Seite (mit `…/slots`).",
|
|
1591
|
+
"tags": [
|
|
1592
|
+
"Site-API"
|
|
1593
|
+
],
|
|
1594
|
+
"security": [],
|
|
1595
|
+
"parameters": [
|
|
1596
|
+
{
|
|
1597
|
+
"name": "key",
|
|
1598
|
+
"in": "path",
|
|
1599
|
+
"required": true,
|
|
1600
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
1601
|
+
"schema": {
|
|
1602
|
+
"type": "string",
|
|
1603
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
1604
|
+
}
|
|
1605
|
+
},
|
|
1606
|
+
{
|
|
1607
|
+
"name": "Origin",
|
|
1608
|
+
"in": "header",
|
|
1609
|
+
"required": true,
|
|
1610
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
1611
|
+
"schema": {
|
|
1612
|
+
"type": "string"
|
|
1613
|
+
}
|
|
1614
|
+
},
|
|
1615
|
+
{
|
|
1616
|
+
"name": "bookingKey",
|
|
1617
|
+
"in": "path",
|
|
1618
|
+
"required": true,
|
|
1619
|
+
"description": "Schlüssel der Buchung aus `booking` in `dealsystem.config.ts`.",
|
|
1620
|
+
"schema": {
|
|
1621
|
+
"type": "string",
|
|
1622
|
+
"pattern": "^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$|^[a-z0-9]$"
|
|
1623
|
+
}
|
|
1624
|
+
}
|
|
1625
|
+
],
|
|
1626
|
+
"responses": {
|
|
1627
|
+
"200": {
|
|
1628
|
+
"description": "Terminart.",
|
|
1629
|
+
"content": {
|
|
1630
|
+
"application/json": {
|
|
1631
|
+
"schema": {
|
|
1632
|
+
"$ref": "#/components/schemas/BookingInfo"
|
|
1633
|
+
},
|
|
1634
|
+
"example": {
|
|
1635
|
+
"data": {
|
|
1636
|
+
"key": "erstgespraech",
|
|
1637
|
+
"label": "Erstgespräch",
|
|
1638
|
+
"title": "Erstgespräch 30 Minuten",
|
|
1639
|
+
"description": null,
|
|
1640
|
+
"durationMinutes": 30,
|
|
1641
|
+
"timezone": "Europe/Berlin",
|
|
1642
|
+
"locations": [
|
|
1643
|
+
{
|
|
1644
|
+
"type": "google_meet",
|
|
1645
|
+
"label": "Videoanruf"
|
|
1646
|
+
}
|
|
1647
|
+
],
|
|
1648
|
+
"questions": [
|
|
1649
|
+
{
|
|
1650
|
+
"key": "anliegen",
|
|
1651
|
+
"label": "Worum geht es?",
|
|
1652
|
+
"type": "textarea",
|
|
1653
|
+
"required": true,
|
|
1654
|
+
"options": null,
|
|
1655
|
+
"placeholder": null
|
|
1656
|
+
}
|
|
1657
|
+
]
|
|
1658
|
+
}
|
|
1659
|
+
}
|
|
1660
|
+
}
|
|
1661
|
+
}
|
|
1662
|
+
},
|
|
1663
|
+
"403": {
|
|
1664
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
1665
|
+
"content": {
|
|
1666
|
+
"application/json": {
|
|
1667
|
+
"schema": {
|
|
1668
|
+
"$ref": "#/components/schemas/Error"
|
|
1669
|
+
},
|
|
1670
|
+
"example": {
|
|
1671
|
+
"error": "Forbidden",
|
|
1672
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
1673
|
+
"status": 403,
|
|
1674
|
+
"code": "origin_not_allowed"
|
|
1675
|
+
}
|
|
1676
|
+
}
|
|
1677
|
+
}
|
|
1678
|
+
},
|
|
1679
|
+
"404": {
|
|
1680
|
+
"description": "`booking_unavailable`: Buchung unbekannt, ausgeschaltet, ohne Terminart, Terminart inaktiv oder Termine-App aus — den Ausweichkontakt zeigen. `site_not_found`: Schlüssel unbekannt oder Seite pausiert.",
|
|
1681
|
+
"content": {
|
|
1682
|
+
"application/json": {
|
|
1683
|
+
"schema": {
|
|
1684
|
+
"$ref": "#/components/schemas/Error"
|
|
1685
|
+
},
|
|
1686
|
+
"example": {
|
|
1687
|
+
"error": "Not Found",
|
|
1688
|
+
"message": "Für diese Terminbuchung sind gerade keine Termine verfügbar. Bitte nimm auf anderem Weg Kontakt auf.",
|
|
1689
|
+
"status": 404,
|
|
1690
|
+
"code": "booking_unavailable"
|
|
1691
|
+
}
|
|
1692
|
+
}
|
|
1693
|
+
}
|
|
1694
|
+
},
|
|
1695
|
+
"429": {
|
|
1696
|
+
"description": "`rate_limited`: 60/min je IP und Seite. Header `Retry-After` (Sekunden).",
|
|
1697
|
+
"content": {
|
|
1698
|
+
"application/json": {
|
|
1699
|
+
"schema": {
|
|
1700
|
+
"$ref": "#/components/schemas/Error"
|
|
1701
|
+
},
|
|
1702
|
+
"example": {
|
|
1703
|
+
"error": "Too Many Requests",
|
|
1704
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
1705
|
+
"status": 429,
|
|
1706
|
+
"code": "rate_limited"
|
|
1707
|
+
}
|
|
1708
|
+
}
|
|
1709
|
+
}
|
|
1710
|
+
}
|
|
1711
|
+
}
|
|
1712
|
+
}
|
|
1713
|
+
},
|
|
1714
|
+
"/s/{key}/booking/{bookingKey}/slots": {
|
|
1715
|
+
"get": {
|
|
1716
|
+
"operationId": "listBookingSlots",
|
|
1717
|
+
"summary": "Freie Zeiten",
|
|
1718
|
+
"description": "Freie Zeiten in UTC, berechnet wie auf der Buchungsseite der Termine-App (Arbeitszeiten, Vorlauf, Buchungsfenster, belegte Kalender). `from`/`to` als ISO-Zeitpunkt oder Datum, höchstens 31 Tage je Abfrage; fehlt `to`, sieben Tage; Vergangenheit beginnt jetzt. `timezone` ist die Zeitzone des Kalenders; zum Anzeigen in die Zone des Besuchers umrechnen. Cache 30 s.",
|
|
1719
|
+
"tags": [
|
|
1720
|
+
"Site-API"
|
|
1721
|
+
],
|
|
1722
|
+
"security": [],
|
|
1723
|
+
"parameters": [
|
|
1724
|
+
{
|
|
1725
|
+
"name": "key",
|
|
1726
|
+
"in": "path",
|
|
1727
|
+
"required": true,
|
|
1728
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
1729
|
+
"schema": {
|
|
1730
|
+
"type": "string",
|
|
1731
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
1732
|
+
}
|
|
1733
|
+
},
|
|
1734
|
+
{
|
|
1735
|
+
"name": "Origin",
|
|
1736
|
+
"in": "header",
|
|
1737
|
+
"required": true,
|
|
1738
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
1739
|
+
"schema": {
|
|
1740
|
+
"type": "string"
|
|
1741
|
+
}
|
|
1742
|
+
},
|
|
1743
|
+
{
|
|
1744
|
+
"name": "bookingKey",
|
|
1745
|
+
"in": "path",
|
|
1746
|
+
"required": true,
|
|
1747
|
+
"description": "Schlüssel der Buchung aus `booking` in `dealsystem.config.ts`.",
|
|
1748
|
+
"schema": {
|
|
1749
|
+
"type": "string",
|
|
1750
|
+
"pattern": "^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$|^[a-z0-9]$"
|
|
1751
|
+
}
|
|
1752
|
+
},
|
|
1753
|
+
{
|
|
1754
|
+
"name": "from",
|
|
1755
|
+
"in": "query",
|
|
1756
|
+
"required": false,
|
|
1757
|
+
"schema": {
|
|
1758
|
+
"type": "string"
|
|
1759
|
+
}
|
|
1760
|
+
},
|
|
1761
|
+
{
|
|
1762
|
+
"name": "to",
|
|
1763
|
+
"in": "query",
|
|
1764
|
+
"required": false,
|
|
1765
|
+
"schema": {
|
|
1766
|
+
"type": "string"
|
|
1767
|
+
}
|
|
1768
|
+
},
|
|
1769
|
+
{
|
|
1770
|
+
"name": "tz",
|
|
1771
|
+
"in": "query",
|
|
1772
|
+
"required": false,
|
|
1773
|
+
"description": "Nur geprüft (IANA); Zeiten bleiben UTC.",
|
|
1774
|
+
"schema": {
|
|
1775
|
+
"type": "string"
|
|
1776
|
+
}
|
|
1777
|
+
}
|
|
1778
|
+
],
|
|
1779
|
+
"responses": {
|
|
1780
|
+
"200": {
|
|
1781
|
+
"description": "Freie Zeiten.",
|
|
1782
|
+
"content": {
|
|
1783
|
+
"application/json": {
|
|
1784
|
+
"schema": {
|
|
1785
|
+
"$ref": "#/components/schemas/BookingSlots"
|
|
1786
|
+
},
|
|
1787
|
+
"example": {
|
|
1788
|
+
"data": {
|
|
1789
|
+
"timezone": "Europe/Berlin",
|
|
1790
|
+
"from": "2026-12-01T00:00:00.000Z",
|
|
1791
|
+
"to": "2026-12-08T00:00:00.000Z",
|
|
1792
|
+
"slots": [
|
|
1793
|
+
{
|
|
1794
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
1795
|
+
"end": "2026-12-01T09:30:00.000Z"
|
|
1796
|
+
}
|
|
1797
|
+
]
|
|
1798
|
+
}
|
|
1799
|
+
}
|
|
1800
|
+
}
|
|
1801
|
+
}
|
|
1802
|
+
},
|
|
1803
|
+
"400": {
|
|
1804
|
+
"description": "`invalid_range` (Format, Reihenfolge, mehr als 31 Tage) oder `invalid_timezone`.",
|
|
1805
|
+
"content": {
|
|
1806
|
+
"application/json": {
|
|
1807
|
+
"schema": {
|
|
1808
|
+
"$ref": "#/components/schemas/Error"
|
|
1809
|
+
},
|
|
1810
|
+
"example": {
|
|
1811
|
+
"error": "Bad Request",
|
|
1812
|
+
"message": "Höchstens 31 Tage je Abfrage",
|
|
1813
|
+
"status": 400,
|
|
1814
|
+
"code": "invalid_range"
|
|
1815
|
+
}
|
|
1816
|
+
}
|
|
1817
|
+
}
|
|
1818
|
+
},
|
|
1819
|
+
"403": {
|
|
1820
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
1821
|
+
"content": {
|
|
1822
|
+
"application/json": {
|
|
1823
|
+
"schema": {
|
|
1824
|
+
"$ref": "#/components/schemas/Error"
|
|
1825
|
+
},
|
|
1826
|
+
"example": {
|
|
1827
|
+
"error": "Forbidden",
|
|
1828
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
1829
|
+
"status": 403,
|
|
1830
|
+
"code": "origin_not_allowed"
|
|
1831
|
+
}
|
|
1832
|
+
}
|
|
1833
|
+
}
|
|
1834
|
+
},
|
|
1835
|
+
"404": {
|
|
1836
|
+
"description": "`booking_unavailable`: Buchung unbekannt, ausgeschaltet, ohne Terminart, Terminart inaktiv oder Termine-App aus — den Ausweichkontakt zeigen. `site_not_found`: Schlüssel unbekannt oder Seite pausiert.",
|
|
1837
|
+
"content": {
|
|
1838
|
+
"application/json": {
|
|
1839
|
+
"schema": {
|
|
1840
|
+
"$ref": "#/components/schemas/Error"
|
|
1841
|
+
},
|
|
1842
|
+
"example": {
|
|
1843
|
+
"error": "Not Found",
|
|
1844
|
+
"message": "Für diese Terminbuchung sind gerade keine Termine verfügbar. Bitte nimm auf anderem Weg Kontakt auf.",
|
|
1845
|
+
"status": 404,
|
|
1846
|
+
"code": "booking_unavailable"
|
|
1847
|
+
}
|
|
1848
|
+
}
|
|
1849
|
+
}
|
|
1850
|
+
},
|
|
1851
|
+
"429": {
|
|
1852
|
+
"description": "`rate_limited`: 60/min je IP und Seite. Header `Retry-After` (Sekunden).",
|
|
1853
|
+
"content": {
|
|
1854
|
+
"application/json": {
|
|
1855
|
+
"schema": {
|
|
1856
|
+
"$ref": "#/components/schemas/Error"
|
|
1857
|
+
},
|
|
1858
|
+
"example": {
|
|
1859
|
+
"error": "Too Many Requests",
|
|
1860
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
1861
|
+
"status": 429,
|
|
1862
|
+
"code": "rate_limited"
|
|
1863
|
+
}
|
|
1864
|
+
}
|
|
1865
|
+
}
|
|
1866
|
+
},
|
|
1867
|
+
"503": {
|
|
1868
|
+
"description": "`slots_unavailable`: Kalender gerade nicht abfragbar.",
|
|
1869
|
+
"content": {
|
|
1870
|
+
"application/json": {
|
|
1871
|
+
"schema": {
|
|
1872
|
+
"$ref": "#/components/schemas/Error"
|
|
1873
|
+
}
|
|
1874
|
+
}
|
|
1875
|
+
}
|
|
1876
|
+
}
|
|
1877
|
+
}
|
|
1878
|
+
}
|
|
1879
|
+
},
|
|
1880
|
+
"/s/{key}/booking/{bookingKey}/bookings": {
|
|
1881
|
+
"post": {
|
|
1882
|
+
"operationId": "createBooking",
|
|
1883
|
+
"summary": "Termin buchen",
|
|
1884
|
+
"description": "Bucht die Zeit über den Buchungskern der Termine-App: Kontakt (ein vorhandener wird nur ergänzt, nie überschrieben), Termin im Kalender des Gastgebers, Mail an die Gastgeber, Automationen. Die Bestätigung an den Buchenden kommt von DealSystem („<Firma> über DealSystem“) mit Links zum Absagen und Verschieben. Aus der Vorschau wird geprüft (Antworten, Zeit frei), aber nichts gebucht (`dryRun`, 200).\n\nAblauf: Rate-Limit → Body (höchstens 64 KB) → Bot-Falle → Body-Form → Captcha → Buchung der Seite → Antworten → Doppel-Einsendung (`submissionId`, 24 h) → Buchen. `start` am besten genau aus `…/slots`; Ende = Beginn + Dauer.",
|
|
1885
|
+
"tags": [
|
|
1886
|
+
"Site-API"
|
|
1887
|
+
],
|
|
1888
|
+
"security": [],
|
|
1889
|
+
"parameters": [
|
|
1890
|
+
{
|
|
1891
|
+
"name": "key",
|
|
1892
|
+
"in": "path",
|
|
1893
|
+
"required": true,
|
|
1894
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
1895
|
+
"schema": {
|
|
1896
|
+
"type": "string",
|
|
1897
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
1898
|
+
}
|
|
1899
|
+
},
|
|
1900
|
+
{
|
|
1901
|
+
"name": "Origin",
|
|
1902
|
+
"in": "header",
|
|
1903
|
+
"required": true,
|
|
1904
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
1905
|
+
"schema": {
|
|
1906
|
+
"type": "string"
|
|
1907
|
+
}
|
|
1908
|
+
},
|
|
1909
|
+
{
|
|
1910
|
+
"name": "bookingKey",
|
|
1911
|
+
"in": "path",
|
|
1912
|
+
"required": true,
|
|
1913
|
+
"description": "Schlüssel der Buchung aus `booking` in `dealsystem.config.ts`.",
|
|
1914
|
+
"schema": {
|
|
1915
|
+
"type": "string",
|
|
1916
|
+
"pattern": "^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$|^[a-z0-9]$"
|
|
1917
|
+
}
|
|
1918
|
+
}
|
|
1919
|
+
],
|
|
1920
|
+
"requestBody": {
|
|
1921
|
+
"required": true,
|
|
1922
|
+
"content": {
|
|
1923
|
+
"application/json": {
|
|
1924
|
+
"schema": {
|
|
1925
|
+
"type": "object",
|
|
1926
|
+
"properties": {
|
|
1927
|
+
"submissionId": {
|
|
1928
|
+
"type": "string",
|
|
1929
|
+
"format": "uuid",
|
|
1930
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
|
|
1931
|
+
"description": "Vom Client je Buchungsvorgang erzeugt. Dieselbe ID innerhalb von 24 h wird nur einmal gebucht."
|
|
1932
|
+
},
|
|
1933
|
+
"start": {
|
|
1934
|
+
"type": "string",
|
|
1935
|
+
"maxLength": 40,
|
|
1936
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})$",
|
|
1937
|
+
"description": "Beginn als ISO-Zeitpunkt mit Zone, am besten genau `start` aus `…/slots` (UTC)."
|
|
1938
|
+
},
|
|
1939
|
+
"tz": {
|
|
1940
|
+
"type": "string",
|
|
1941
|
+
"maxLength": 64,
|
|
1942
|
+
"description": "IANA-Zeitzone des Buchenden (z. B. `Europe/Berlin`), für die Zeiten in der Bestätigung."
|
|
1943
|
+
},
|
|
1944
|
+
"attendee": {
|
|
1945
|
+
"type": "object",
|
|
1946
|
+
"properties": {
|
|
1947
|
+
"firstName": {
|
|
1948
|
+
"type": "string",
|
|
1949
|
+
"minLength": 1,
|
|
1950
|
+
"maxLength": 100
|
|
1951
|
+
},
|
|
1952
|
+
"lastName": {
|
|
1953
|
+
"type": "string",
|
|
1954
|
+
"maxLength": 100
|
|
1955
|
+
},
|
|
1956
|
+
"email": {
|
|
1957
|
+
"type": "string",
|
|
1958
|
+
"maxLength": 254,
|
|
1959
|
+
"format": "email",
|
|
1960
|
+
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
|
|
1961
|
+
},
|
|
1962
|
+
"phone": {
|
|
1963
|
+
"type": "string",
|
|
1964
|
+
"maxLength": 50
|
|
1965
|
+
}
|
|
1966
|
+
},
|
|
1967
|
+
"required": [
|
|
1968
|
+
"firstName",
|
|
1969
|
+
"email"
|
|
1970
|
+
],
|
|
1971
|
+
"additionalProperties": false
|
|
1972
|
+
},
|
|
1973
|
+
"answers": {
|
|
1974
|
+
"description": "Antworten auf die Buchungsfragen (`questions[].key` aus `GET …/booking/{bookingKey}`).",
|
|
1975
|
+
"type": "object",
|
|
1976
|
+
"propertyNames": {
|
|
1977
|
+
"type": "string",
|
|
1978
|
+
"maxLength": 100
|
|
1979
|
+
},
|
|
1980
|
+
"additionalProperties": {
|
|
1981
|
+
"anyOf": [
|
|
1982
|
+
{
|
|
1983
|
+
"type": "string",
|
|
1984
|
+
"maxLength": 5000
|
|
1985
|
+
},
|
|
1986
|
+
{
|
|
1987
|
+
"type": "number"
|
|
1988
|
+
},
|
|
1989
|
+
{
|
|
1990
|
+
"type": "boolean"
|
|
1991
|
+
},
|
|
1992
|
+
{
|
|
1993
|
+
"maxItems": 50,
|
|
1994
|
+
"type": "array",
|
|
1995
|
+
"items": {
|
|
1996
|
+
"type": "string",
|
|
1997
|
+
"maxLength": 500
|
|
1998
|
+
}
|
|
1999
|
+
}
|
|
2000
|
+
]
|
|
2001
|
+
}
|
|
2002
|
+
},
|
|
2003
|
+
"locationType": {
|
|
2004
|
+
"description": "Gewählte Ort-Art aus `locations[].type`; fehlt sie, gilt die erste.",
|
|
2005
|
+
"type": "string",
|
|
2006
|
+
"enum": [
|
|
2007
|
+
"google_meet",
|
|
2008
|
+
"in_person",
|
|
2009
|
+
"phone",
|
|
2010
|
+
"link"
|
|
2011
|
+
]
|
|
2012
|
+
},
|
|
2013
|
+
"attribution": {
|
|
2014
|
+
"anyOf": [
|
|
2015
|
+
{
|
|
2016
|
+
"type": "object",
|
|
2017
|
+
"properties": {
|
|
2018
|
+
"v": {
|
|
2019
|
+
"type": "number",
|
|
2020
|
+
"const": 2
|
|
2021
|
+
},
|
|
2022
|
+
"first": {
|
|
2023
|
+
"description": "Erster Besuch (First Touch).",
|
|
2024
|
+
"anyOf": [
|
|
2025
|
+
{
|
|
2026
|
+
"type": "object",
|
|
2027
|
+
"properties": {
|
|
2028
|
+
"source": {
|
|
2029
|
+
"anyOf": [
|
|
2030
|
+
{
|
|
2031
|
+
"type": "string",
|
|
2032
|
+
"maxLength": 200
|
|
2033
|
+
},
|
|
2034
|
+
{
|
|
2035
|
+
"type": "null"
|
|
2036
|
+
}
|
|
2037
|
+
]
|
|
2038
|
+
},
|
|
2039
|
+
"medium": {
|
|
2040
|
+
"anyOf": [
|
|
2041
|
+
{
|
|
2042
|
+
"type": "string",
|
|
2043
|
+
"maxLength": 200
|
|
2044
|
+
},
|
|
2045
|
+
{
|
|
2046
|
+
"type": "null"
|
|
2047
|
+
}
|
|
2048
|
+
]
|
|
2049
|
+
},
|
|
2050
|
+
"campaign": {
|
|
2051
|
+
"anyOf": [
|
|
2052
|
+
{
|
|
2053
|
+
"type": "string",
|
|
2054
|
+
"maxLength": 200
|
|
2055
|
+
},
|
|
2056
|
+
{
|
|
2057
|
+
"type": "null"
|
|
2058
|
+
}
|
|
2059
|
+
]
|
|
2060
|
+
},
|
|
2061
|
+
"term": {
|
|
2062
|
+
"anyOf": [
|
|
2063
|
+
{
|
|
2064
|
+
"type": "string",
|
|
2065
|
+
"maxLength": 200
|
|
2066
|
+
},
|
|
2067
|
+
{
|
|
2068
|
+
"type": "null"
|
|
2069
|
+
}
|
|
2070
|
+
]
|
|
2071
|
+
},
|
|
2072
|
+
"content": {
|
|
2073
|
+
"anyOf": [
|
|
2074
|
+
{
|
|
2075
|
+
"type": "string",
|
|
2076
|
+
"maxLength": 200
|
|
2077
|
+
},
|
|
2078
|
+
{
|
|
2079
|
+
"type": "null"
|
|
2080
|
+
}
|
|
2081
|
+
]
|
|
2082
|
+
},
|
|
2083
|
+
"referrerHost": {
|
|
2084
|
+
"description": "Nur der Host, ohne Schema und Pfad.",
|
|
2085
|
+
"anyOf": [
|
|
2086
|
+
{
|
|
2087
|
+
"type": "string",
|
|
2088
|
+
"maxLength": 255
|
|
2089
|
+
},
|
|
2090
|
+
{
|
|
2091
|
+
"type": "null"
|
|
2092
|
+
}
|
|
2093
|
+
]
|
|
2094
|
+
},
|
|
2095
|
+
"landingPath": {
|
|
2096
|
+
"description": "Einstiegsseite (Pfad). Query und Fragment entfernt der Core vor dem Speichern.",
|
|
2097
|
+
"anyOf": [
|
|
2098
|
+
{
|
|
2099
|
+
"type": "string",
|
|
2100
|
+
"maxLength": 2000
|
|
2101
|
+
},
|
|
2102
|
+
{
|
|
2103
|
+
"type": "null"
|
|
2104
|
+
}
|
|
2105
|
+
]
|
|
2106
|
+
},
|
|
2107
|
+
"at": {
|
|
2108
|
+
"description": "Zeitpunkt des Besuchs (ISO 8601).",
|
|
2109
|
+
"anyOf": [
|
|
2110
|
+
{
|
|
2111
|
+
"type": "string",
|
|
2112
|
+
"maxLength": 64
|
|
2113
|
+
},
|
|
2114
|
+
{
|
|
2115
|
+
"type": "null"
|
|
2116
|
+
}
|
|
2117
|
+
]
|
|
2118
|
+
}
|
|
2119
|
+
},
|
|
2120
|
+
"additionalProperties": false
|
|
2121
|
+
},
|
|
2122
|
+
{
|
|
2123
|
+
"type": "null"
|
|
2124
|
+
}
|
|
2125
|
+
]
|
|
2126
|
+
},
|
|
2127
|
+
"last": {
|
|
2128
|
+
"description": "Letzter Besuch vor der Anfrage (Last Touch).",
|
|
2129
|
+
"anyOf": [
|
|
2130
|
+
{
|
|
2131
|
+
"type": "object",
|
|
2132
|
+
"properties": {
|
|
2133
|
+
"source": {
|
|
2134
|
+
"anyOf": [
|
|
2135
|
+
{
|
|
2136
|
+
"type": "string",
|
|
2137
|
+
"maxLength": 200
|
|
2138
|
+
},
|
|
2139
|
+
{
|
|
2140
|
+
"type": "null"
|
|
2141
|
+
}
|
|
2142
|
+
]
|
|
2143
|
+
},
|
|
2144
|
+
"medium": {
|
|
2145
|
+
"anyOf": [
|
|
2146
|
+
{
|
|
2147
|
+
"type": "string",
|
|
2148
|
+
"maxLength": 200
|
|
2149
|
+
},
|
|
2150
|
+
{
|
|
2151
|
+
"type": "null"
|
|
2152
|
+
}
|
|
2153
|
+
]
|
|
2154
|
+
},
|
|
2155
|
+
"campaign": {
|
|
2156
|
+
"anyOf": [
|
|
2157
|
+
{
|
|
2158
|
+
"type": "string",
|
|
2159
|
+
"maxLength": 200
|
|
2160
|
+
},
|
|
2161
|
+
{
|
|
2162
|
+
"type": "null"
|
|
2163
|
+
}
|
|
2164
|
+
]
|
|
2165
|
+
},
|
|
2166
|
+
"term": {
|
|
2167
|
+
"anyOf": [
|
|
2168
|
+
{
|
|
2169
|
+
"type": "string",
|
|
2170
|
+
"maxLength": 200
|
|
2171
|
+
},
|
|
2172
|
+
{
|
|
2173
|
+
"type": "null"
|
|
2174
|
+
}
|
|
2175
|
+
]
|
|
2176
|
+
},
|
|
2177
|
+
"content": {
|
|
2178
|
+
"anyOf": [
|
|
2179
|
+
{
|
|
2180
|
+
"type": "string",
|
|
2181
|
+
"maxLength": 200
|
|
2182
|
+
},
|
|
2183
|
+
{
|
|
2184
|
+
"type": "null"
|
|
2185
|
+
}
|
|
2186
|
+
]
|
|
2187
|
+
},
|
|
2188
|
+
"referrerHost": {
|
|
2189
|
+
"description": "Nur der Host, ohne Schema und Pfad.",
|
|
2190
|
+
"anyOf": [
|
|
2191
|
+
{
|
|
2192
|
+
"type": "string",
|
|
2193
|
+
"maxLength": 255
|
|
2194
|
+
},
|
|
2195
|
+
{
|
|
2196
|
+
"type": "null"
|
|
2197
|
+
}
|
|
2198
|
+
]
|
|
2199
|
+
},
|
|
2200
|
+
"landingPath": {
|
|
2201
|
+
"description": "Einstiegsseite (Pfad). Query und Fragment entfernt der Core vor dem Speichern.",
|
|
2202
|
+
"anyOf": [
|
|
2203
|
+
{
|
|
2204
|
+
"type": "string",
|
|
2205
|
+
"maxLength": 2000
|
|
2206
|
+
},
|
|
2207
|
+
{
|
|
2208
|
+
"type": "null"
|
|
2209
|
+
}
|
|
2210
|
+
]
|
|
2211
|
+
},
|
|
2212
|
+
"at": {
|
|
2213
|
+
"description": "Zeitpunkt des Besuchs (ISO 8601).",
|
|
2214
|
+
"anyOf": [
|
|
2215
|
+
{
|
|
2216
|
+
"type": "string",
|
|
2217
|
+
"maxLength": 64
|
|
2218
|
+
},
|
|
2219
|
+
{
|
|
2220
|
+
"type": "null"
|
|
2221
|
+
}
|
|
2222
|
+
]
|
|
2223
|
+
}
|
|
2224
|
+
},
|
|
2225
|
+
"additionalProperties": false
|
|
2226
|
+
},
|
|
2227
|
+
{
|
|
2228
|
+
"type": "null"
|
|
2229
|
+
}
|
|
2230
|
+
]
|
|
2231
|
+
},
|
|
2232
|
+
"touches": {
|
|
2233
|
+
"description": "Anzahl der Besuche bis zur Anfrage.",
|
|
2234
|
+
"anyOf": [
|
|
2235
|
+
{
|
|
2236
|
+
"type": "integer",
|
|
2237
|
+
"minimum": 0,
|
|
2238
|
+
"maximum": 1000
|
|
2239
|
+
},
|
|
2240
|
+
{
|
|
2241
|
+
"type": "null"
|
|
2242
|
+
}
|
|
2243
|
+
]
|
|
2244
|
+
},
|
|
2245
|
+
"clickIds": {
|
|
2246
|
+
"description": "Klick-IDs der Werbenetze. Nur mit `consent.marketing: true` gespeichert.",
|
|
2247
|
+
"anyOf": [
|
|
2248
|
+
{
|
|
2249
|
+
"type": "object",
|
|
2250
|
+
"properties": {
|
|
2251
|
+
"gclid": {
|
|
2252
|
+
"anyOf": [
|
|
2253
|
+
{
|
|
2254
|
+
"type": "string",
|
|
2255
|
+
"maxLength": 500
|
|
2256
|
+
},
|
|
2257
|
+
{
|
|
2258
|
+
"type": "null"
|
|
2259
|
+
}
|
|
2260
|
+
]
|
|
2261
|
+
},
|
|
2262
|
+
"gbraid": {
|
|
2263
|
+
"anyOf": [
|
|
2264
|
+
{
|
|
2265
|
+
"type": "string",
|
|
2266
|
+
"maxLength": 500
|
|
2267
|
+
},
|
|
2268
|
+
{
|
|
2269
|
+
"type": "null"
|
|
2270
|
+
}
|
|
2271
|
+
]
|
|
2272
|
+
},
|
|
2273
|
+
"wbraid": {
|
|
2274
|
+
"anyOf": [
|
|
2275
|
+
{
|
|
2276
|
+
"type": "string",
|
|
2277
|
+
"maxLength": 500
|
|
2278
|
+
},
|
|
2279
|
+
{
|
|
2280
|
+
"type": "null"
|
|
2281
|
+
}
|
|
2282
|
+
]
|
|
2283
|
+
},
|
|
2284
|
+
"fbc": {
|
|
2285
|
+
"description": "Meta-Format `fb.1.<ms>.<fbclid>`.",
|
|
2286
|
+
"anyOf": [
|
|
2287
|
+
{
|
|
2288
|
+
"type": "string",
|
|
2289
|
+
"maxLength": 500
|
|
2290
|
+
},
|
|
2291
|
+
{
|
|
2292
|
+
"type": "null"
|
|
2293
|
+
}
|
|
2294
|
+
]
|
|
2295
|
+
},
|
|
2296
|
+
"fbp": {
|
|
2297
|
+
"description": "Wert des Pixel-Cookies `_fbp`.",
|
|
2298
|
+
"anyOf": [
|
|
2299
|
+
{
|
|
2300
|
+
"type": "string",
|
|
2301
|
+
"maxLength": 500
|
|
2302
|
+
},
|
|
2303
|
+
{
|
|
2304
|
+
"type": "null"
|
|
2305
|
+
}
|
|
2306
|
+
]
|
|
2307
|
+
},
|
|
2308
|
+
"msclkid": {
|
|
2309
|
+
"anyOf": [
|
|
2310
|
+
{
|
|
2311
|
+
"type": "string",
|
|
2312
|
+
"maxLength": 500
|
|
2313
|
+
},
|
|
2314
|
+
{
|
|
2315
|
+
"type": "null"
|
|
2316
|
+
}
|
|
2317
|
+
]
|
|
2318
|
+
}
|
|
2319
|
+
},
|
|
2320
|
+
"additionalProperties": false
|
|
2321
|
+
},
|
|
2322
|
+
{
|
|
2323
|
+
"type": "null"
|
|
2324
|
+
}
|
|
2325
|
+
]
|
|
2326
|
+
},
|
|
2327
|
+
"visitorId": {
|
|
2328
|
+
"description": "Zufalls-UUID des Browsers. Nur mit `consent.marketing: true` gespeichert.",
|
|
2329
|
+
"anyOf": [
|
|
2330
|
+
{
|
|
2331
|
+
"type": "string",
|
|
2332
|
+
"format": "uuid",
|
|
2333
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
|
|
2334
|
+
},
|
|
2335
|
+
{
|
|
2336
|
+
"type": "null"
|
|
2337
|
+
}
|
|
2338
|
+
]
|
|
2339
|
+
},
|
|
2340
|
+
"params": {
|
|
2341
|
+
"description": "Eigene URL-Parameter des aktuellen Besuchs (z. B. `partner`).",
|
|
2342
|
+
"anyOf": [
|
|
2343
|
+
{
|
|
2344
|
+
"type": "object",
|
|
2345
|
+
"propertyNames": {
|
|
2346
|
+
"type": "string",
|
|
2347
|
+
"pattern": "^[A-Za-z0-9_.-]{1,64}$"
|
|
2348
|
+
},
|
|
2349
|
+
"additionalProperties": {
|
|
2350
|
+
"type": "string",
|
|
2351
|
+
"maxLength": 500
|
|
2352
|
+
}
|
|
2353
|
+
},
|
|
2354
|
+
{
|
|
2355
|
+
"type": "null"
|
|
2356
|
+
}
|
|
2357
|
+
]
|
|
2358
|
+
},
|
|
2359
|
+
"consent": {
|
|
2360
|
+
"type": "object",
|
|
2361
|
+
"properties": {
|
|
2362
|
+
"statistics": {
|
|
2363
|
+
"type": "boolean"
|
|
2364
|
+
},
|
|
2365
|
+
"marketing": {
|
|
2366
|
+
"type": "boolean"
|
|
2367
|
+
},
|
|
2368
|
+
"at": {
|
|
2369
|
+
"description": "Zeitpunkt der Einwilligung (ISO 8601).",
|
|
2370
|
+
"anyOf": [
|
|
2371
|
+
{
|
|
2372
|
+
"type": "string",
|
|
2373
|
+
"maxLength": 64
|
|
2374
|
+
},
|
|
2375
|
+
{
|
|
2376
|
+
"type": "null"
|
|
2377
|
+
}
|
|
2378
|
+
]
|
|
2379
|
+
}
|
|
2380
|
+
},
|
|
2381
|
+
"required": [
|
|
2382
|
+
"statistics",
|
|
2383
|
+
"marketing"
|
|
2384
|
+
],
|
|
2385
|
+
"additionalProperties": false,
|
|
2386
|
+
"description": "Einwilligung des Besuchers aus dem Cookie-Banner. `visitorId` und `clickIds` zählen nur mit `marketing: true` — sonst verwirft der Core sie vor dem Speichern."
|
|
2387
|
+
}
|
|
2388
|
+
},
|
|
2389
|
+
"required": [
|
|
2390
|
+
"v",
|
|
2391
|
+
"consent"
|
|
2392
|
+
],
|
|
2393
|
+
"additionalProperties": false,
|
|
2394
|
+
"description": "Fassung 2: First/Last Touch über Besuche, Klick-IDs, Besuchs-ID, Einwilligung."
|
|
2395
|
+
},
|
|
2396
|
+
{
|
|
2397
|
+
"type": "object",
|
|
2398
|
+
"properties": {
|
|
2399
|
+
"utmSource": {
|
|
2400
|
+
"type": "string",
|
|
2401
|
+
"maxLength": 200
|
|
2402
|
+
},
|
|
2403
|
+
"utmMedium": {
|
|
2404
|
+
"type": "string",
|
|
2405
|
+
"maxLength": 200
|
|
2406
|
+
},
|
|
2407
|
+
"utmCampaign": {
|
|
2408
|
+
"type": "string",
|
|
2409
|
+
"maxLength": 200
|
|
2410
|
+
},
|
|
2411
|
+
"utmTerm": {
|
|
2412
|
+
"type": "string",
|
|
2413
|
+
"maxLength": 200
|
|
2414
|
+
},
|
|
2415
|
+
"utmContent": {
|
|
2416
|
+
"type": "string",
|
|
2417
|
+
"maxLength": 200
|
|
2418
|
+
},
|
|
2419
|
+
"referrerHost": {
|
|
2420
|
+
"type": "string",
|
|
2421
|
+
"maxLength": 255
|
|
2422
|
+
},
|
|
2423
|
+
"capturedAt": {
|
|
2424
|
+
"type": "string",
|
|
2425
|
+
"maxLength": 64
|
|
2426
|
+
}
|
|
2427
|
+
},
|
|
2428
|
+
"additionalProperties": false,
|
|
2429
|
+
"description": "Fassung 1 (flach, ältere SDKs): erster Kontaktpunkt des aktuellen Besuchs (UTM, Referrer). Wird weiter angenommen; gespeichert wie Fassung 2 ohne Einwilligung."
|
|
2430
|
+
}
|
|
2431
|
+
],
|
|
2432
|
+
"description": "Herkunft des Leads. Optional. Fassung 2 (`v: 2`) oder die flache Fassung 1. Ohne Einwilligung hält das SDK nur den aktuellen Besuch im Arbeitsspeicher (TDDDG § 25)."
|
|
2433
|
+
},
|
|
2434
|
+
"captcha": {
|
|
2435
|
+
"type": "string",
|
|
2436
|
+
"minLength": 1,
|
|
2437
|
+
"maxLength": 4000,
|
|
2438
|
+
"description": "Lösung des Captchas wie bei `…/leads` (ALTCHA v3, einmal, 10 Minuten, nur diese Seite)."
|
|
2439
|
+
},
|
|
2440
|
+
"website": {
|
|
2441
|
+
"description": "Bot-Falle: unsichtbares Feld, bleibt leer. Ist es gefüllt, wird nichts gebucht.",
|
|
2442
|
+
"type": "string",
|
|
2443
|
+
"maxLength": 500
|
|
2444
|
+
}
|
|
2445
|
+
},
|
|
2446
|
+
"required": [
|
|
2447
|
+
"submissionId",
|
|
2448
|
+
"start",
|
|
2449
|
+
"tz",
|
|
2450
|
+
"attendee",
|
|
2451
|
+
"captcha"
|
|
2452
|
+
],
|
|
2453
|
+
"additionalProperties": false
|
|
2454
|
+
},
|
|
2455
|
+
"example": {
|
|
2456
|
+
"submissionId": "0b7e3c9a-2f4d-4e8b-9a1c-5d6e7f8a9b0c",
|
|
2457
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
2458
|
+
"tz": "Europe/Berlin",
|
|
2459
|
+
"attendee": {
|
|
2460
|
+
"firstName": "Erika",
|
|
2461
|
+
"lastName": "Muster",
|
|
2462
|
+
"email": "erika@example.de"
|
|
2463
|
+
},
|
|
2464
|
+
"answers": {
|
|
2465
|
+
"anliegen": "Wohnung bewerten"
|
|
2466
|
+
},
|
|
2467
|
+
"captcha": "eyJhbGdvcml0aG0iOiJTSEEtMjU2In0",
|
|
2468
|
+
"website": ""
|
|
2469
|
+
}
|
|
2470
|
+
}
|
|
2471
|
+
}
|
|
2472
|
+
},
|
|
2473
|
+
"responses": {
|
|
2474
|
+
"200": {
|
|
2475
|
+
"description": "Vorschau: geprüft, nichts gebucht.",
|
|
2476
|
+
"content": {
|
|
2477
|
+
"application/json": {
|
|
2478
|
+
"schema": {
|
|
2479
|
+
"$ref": "#/components/schemas/BookingCreated"
|
|
2480
|
+
},
|
|
2481
|
+
"example": {
|
|
2482
|
+
"data": {
|
|
2483
|
+
"booked": true,
|
|
2484
|
+
"dryRun": true,
|
|
2485
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
2486
|
+
"end": "2026-12-01T09:30:00.000Z"
|
|
2487
|
+
}
|
|
2488
|
+
}
|
|
2489
|
+
}
|
|
2490
|
+
}
|
|
2491
|
+
},
|
|
2492
|
+
"201": {
|
|
2493
|
+
"description": "Gebucht. Auch bei wiederholter `submissionId` (`duplicate: true`) und gefüllter Bot-Falle.",
|
|
2494
|
+
"content": {
|
|
2495
|
+
"application/json": {
|
|
2496
|
+
"schema": {
|
|
2497
|
+
"$ref": "#/components/schemas/BookingCreated"
|
|
2498
|
+
},
|
|
2499
|
+
"example": {
|
|
2500
|
+
"data": {
|
|
2501
|
+
"booked": true,
|
|
2502
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
2503
|
+
"end": "2026-12-01T09:30:00.000Z",
|
|
2504
|
+
"timezone": "Europe/Berlin"
|
|
2505
|
+
}
|
|
2506
|
+
}
|
|
2507
|
+
}
|
|
2508
|
+
}
|
|
2509
|
+
},
|
|
2510
|
+
"400": {
|
|
2511
|
+
"description": "`captcha_failed` (neue Challenge holen) oder `invalid_json`.",
|
|
2512
|
+
"content": {
|
|
2513
|
+
"application/json": {
|
|
2514
|
+
"schema": {
|
|
2515
|
+
"$ref": "#/components/schemas/Error"
|
|
2516
|
+
},
|
|
2517
|
+
"example": {
|
|
2518
|
+
"error": "Bad Request",
|
|
2519
|
+
"message": "Die Sicherheitsprüfung ist fehlgeschlagen. Bitte erneut versuchen.",
|
|
2520
|
+
"status": 400,
|
|
2521
|
+
"code": "captcha_failed"
|
|
2522
|
+
}
|
|
2523
|
+
}
|
|
2524
|
+
}
|
|
2525
|
+
},
|
|
2526
|
+
"403": {
|
|
2527
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
2528
|
+
"content": {
|
|
2529
|
+
"application/json": {
|
|
2530
|
+
"schema": {
|
|
2531
|
+
"$ref": "#/components/schemas/Error"
|
|
2532
|
+
},
|
|
2533
|
+
"example": {
|
|
2534
|
+
"error": "Forbidden",
|
|
2535
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
2536
|
+
"status": 403,
|
|
2537
|
+
"code": "origin_not_allowed"
|
|
2538
|
+
}
|
|
2539
|
+
}
|
|
2540
|
+
}
|
|
2541
|
+
},
|
|
2542
|
+
"404": {
|
|
2543
|
+
"description": "`booking_unavailable`: Buchung unbekannt, ausgeschaltet, ohne Terminart, Terminart inaktiv oder Termine-App aus — den Ausweichkontakt zeigen. `site_not_found`: Schlüssel unbekannt oder Seite pausiert.",
|
|
2544
|
+
"content": {
|
|
2545
|
+
"application/json": {
|
|
2546
|
+
"schema": {
|
|
2547
|
+
"$ref": "#/components/schemas/Error"
|
|
2548
|
+
},
|
|
2549
|
+
"example": {
|
|
2550
|
+
"error": "Not Found",
|
|
2551
|
+
"message": "Für diese Terminbuchung sind gerade keine Termine verfügbar. Bitte nimm auf anderem Weg Kontakt auf.",
|
|
2552
|
+
"status": 404,
|
|
2553
|
+
"code": "booking_unavailable"
|
|
2554
|
+
}
|
|
2555
|
+
}
|
|
2556
|
+
}
|
|
2557
|
+
},
|
|
2558
|
+
"409": {
|
|
2559
|
+
"description": "`slot_taken`: die Zeit ist inzwischen vergeben oder nicht (mehr) buchbar — freie Zeiten neu laden.",
|
|
2560
|
+
"content": {
|
|
2561
|
+
"application/json": {
|
|
2562
|
+
"schema": {
|
|
2563
|
+
"$ref": "#/components/schemas/Error"
|
|
2564
|
+
},
|
|
2565
|
+
"example": {
|
|
2566
|
+
"error": "Conflict",
|
|
2567
|
+
"message": "Diese Zeit ist nicht (mehr) frei. Bitte wähle eine andere.",
|
|
2568
|
+
"status": 409,
|
|
2569
|
+
"code": "slot_taken"
|
|
2570
|
+
}
|
|
2571
|
+
}
|
|
2572
|
+
}
|
|
2573
|
+
},
|
|
2574
|
+
"413": {
|
|
2575
|
+
"description": "`payload_too_large`: Body größer als 64 KB.",
|
|
2576
|
+
"content": {
|
|
2577
|
+
"application/json": {
|
|
2578
|
+
"schema": {
|
|
2579
|
+
"$ref": "#/components/schemas/Error"
|
|
2580
|
+
}
|
|
2581
|
+
}
|
|
2582
|
+
}
|
|
2583
|
+
},
|
|
2584
|
+
"422": {
|
|
2585
|
+
"description": "`validation_error` (Body-Form, Antworten auf die Buchungsfragen; `details`) oder `not_qualified` (Antworten passen nicht zu den Regeln der Terminart).",
|
|
2586
|
+
"content": {
|
|
2587
|
+
"application/json": {
|
|
2588
|
+
"schema": {
|
|
2589
|
+
"$ref": "#/components/schemas/Error"
|
|
2590
|
+
},
|
|
2591
|
+
"example": {
|
|
2592
|
+
"error": "Validation Error",
|
|
2593
|
+
"message": "answers.anliegen: Pflichtfeld",
|
|
2594
|
+
"status": 422,
|
|
2595
|
+
"code": "validation_error",
|
|
2596
|
+
"details": [
|
|
2597
|
+
{
|
|
2598
|
+
"path": "answers.anliegen",
|
|
2599
|
+
"message": "Pflichtfeld"
|
|
2600
|
+
}
|
|
2601
|
+
]
|
|
2602
|
+
}
|
|
2603
|
+
}
|
|
2604
|
+
}
|
|
2605
|
+
},
|
|
2606
|
+
"429": {
|
|
2607
|
+
"description": "`rate_limited`: 5/min und 30/h je IP und Seite, 60/min und 1 000/Tag je Seite (wie Leads). Header `Retry-After` (Sekunden).",
|
|
2608
|
+
"content": {
|
|
2609
|
+
"application/json": {
|
|
2610
|
+
"schema": {
|
|
2611
|
+
"$ref": "#/components/schemas/Error"
|
|
2612
|
+
},
|
|
2613
|
+
"example": {
|
|
2614
|
+
"error": "Too Many Requests",
|
|
2615
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
2616
|
+
"status": 429,
|
|
2617
|
+
"code": "rate_limited"
|
|
2618
|
+
}
|
|
2619
|
+
}
|
|
2620
|
+
}
|
|
2621
|
+
},
|
|
2622
|
+
"500": {
|
|
2623
|
+
"description": "`internal_error`: dieselbe `submissionId` darf erneut gesendet werden.",
|
|
2624
|
+
"content": {
|
|
2625
|
+
"application/json": {
|
|
2626
|
+
"schema": {
|
|
2627
|
+
"$ref": "#/components/schemas/Error"
|
|
2628
|
+
}
|
|
2629
|
+
}
|
|
2630
|
+
}
|
|
2631
|
+
},
|
|
2632
|
+
"503": {
|
|
2633
|
+
"description": "`captcha_unavailable` oder `slots_unavailable`.",
|
|
2634
|
+
"content": {
|
|
2635
|
+
"application/json": {
|
|
2636
|
+
"schema": {
|
|
2637
|
+
"$ref": "#/components/schemas/Error"
|
|
2638
|
+
}
|
|
2639
|
+
}
|
|
2640
|
+
}
|
|
2641
|
+
}
|
|
2642
|
+
}
|
|
2643
|
+
}
|
|
2644
|
+
},
|
|
2645
|
+
"/s/{key}/appointments/{token}": {
|
|
2646
|
+
"get": {
|
|
2647
|
+
"operationId": "getAppointment",
|
|
2648
|
+
"summary": "Gebuchter Termin",
|
|
2649
|
+
"description": "Termin per Token aus der Bestätigung: Zeit, Zustand, ob er noch geändert werden kann. 10/min je IP.",
|
|
2650
|
+
"tags": [
|
|
2651
|
+
"Site-API"
|
|
2652
|
+
],
|
|
2653
|
+
"security": [],
|
|
2654
|
+
"parameters": [
|
|
2655
|
+
{
|
|
2656
|
+
"name": "key",
|
|
2657
|
+
"in": "path",
|
|
2658
|
+
"required": true,
|
|
2659
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
2660
|
+
"schema": {
|
|
2661
|
+
"type": "string",
|
|
2662
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
2663
|
+
}
|
|
2664
|
+
},
|
|
2665
|
+
{
|
|
2666
|
+
"name": "Origin",
|
|
2667
|
+
"in": "header",
|
|
2668
|
+
"required": true,
|
|
2669
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
2670
|
+
"schema": {
|
|
2671
|
+
"type": "string"
|
|
2672
|
+
}
|
|
2673
|
+
},
|
|
2674
|
+
{
|
|
2675
|
+
"name": "token",
|
|
2676
|
+
"in": "path",
|
|
2677
|
+
"required": true,
|
|
2678
|
+
"description": "Token des Termins aus der Bestätigungs-Mail (32 Hex-Zeichen).",
|
|
2679
|
+
"schema": {
|
|
2680
|
+
"type": "string",
|
|
2681
|
+
"pattern": "^[0-9a-f]{32}$"
|
|
2682
|
+
}
|
|
2683
|
+
}
|
|
2684
|
+
],
|
|
2685
|
+
"responses": {
|
|
2686
|
+
"200": {
|
|
2687
|
+
"description": "Termin.",
|
|
2688
|
+
"content": {
|
|
2689
|
+
"application/json": {
|
|
2690
|
+
"schema": {
|
|
2691
|
+
"$ref": "#/components/schemas/Appointment"
|
|
2692
|
+
},
|
|
2693
|
+
"example": {
|
|
2694
|
+
"data": {
|
|
2695
|
+
"bookingKey": "erstgespraech",
|
|
2696
|
+
"label": "Erstgespräch",
|
|
2697
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
2698
|
+
"end": "2026-12-01T09:30:00.000Z",
|
|
2699
|
+
"status": "booked",
|
|
2700
|
+
"canChange": true
|
|
2701
|
+
}
|
|
2702
|
+
}
|
|
2703
|
+
}
|
|
2704
|
+
}
|
|
2705
|
+
},
|
|
2706
|
+
"403": {
|
|
2707
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
2708
|
+
"content": {
|
|
2709
|
+
"application/json": {
|
|
2710
|
+
"schema": {
|
|
2711
|
+
"$ref": "#/components/schemas/Error"
|
|
2712
|
+
},
|
|
2713
|
+
"example": {
|
|
2714
|
+
"error": "Forbidden",
|
|
2715
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
2716
|
+
"status": 403,
|
|
2717
|
+
"code": "origin_not_allowed"
|
|
2718
|
+
}
|
|
2719
|
+
}
|
|
2720
|
+
}
|
|
2721
|
+
},
|
|
2722
|
+
"404": {
|
|
2723
|
+
"description": "`appointment_not_found`: Token unbekannt, Termin abgesagt oder nicht von dieser Seite.",
|
|
2724
|
+
"content": {
|
|
2725
|
+
"application/json": {
|
|
2726
|
+
"schema": {
|
|
2727
|
+
"$ref": "#/components/schemas/Error"
|
|
2728
|
+
},
|
|
2729
|
+
"example": {
|
|
2730
|
+
"error": "Not Found",
|
|
2731
|
+
"message": "Dieser Link ist ungültig oder abgelaufen.",
|
|
2732
|
+
"status": 404,
|
|
2733
|
+
"code": "appointment_not_found"
|
|
2734
|
+
}
|
|
2735
|
+
}
|
|
2736
|
+
}
|
|
2737
|
+
},
|
|
2738
|
+
"429": {
|
|
2739
|
+
"description": "`rate_limited`: 10/min je IP. Header `Retry-After` (Sekunden).",
|
|
2740
|
+
"content": {
|
|
2741
|
+
"application/json": {
|
|
2742
|
+
"schema": {
|
|
2743
|
+
"$ref": "#/components/schemas/Error"
|
|
2744
|
+
},
|
|
2745
|
+
"example": {
|
|
2746
|
+
"error": "Too Many Requests",
|
|
2747
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
2748
|
+
"status": 429,
|
|
2749
|
+
"code": "rate_limited"
|
|
2750
|
+
}
|
|
2751
|
+
}
|
|
2752
|
+
}
|
|
2753
|
+
}
|
|
2754
|
+
}
|
|
2755
|
+
}
|
|
2756
|
+
},
|
|
2757
|
+
"/s/{key}/appointments/{token}/cancel": {
|
|
2758
|
+
"post": {
|
|
2759
|
+
"operationId": "cancelAppointment",
|
|
2760
|
+
"summary": "Termin absagen",
|
|
2761
|
+
"description": "Sagt den Termin ab (Body `{}`), mit Mail an Gast und Gastgeber wie auf der Buchungsseite. Danach gilt der Token nicht mehr. Vorschau: `dryRun`, nichts geändert.",
|
|
2762
|
+
"tags": [
|
|
2763
|
+
"Site-API"
|
|
2764
|
+
],
|
|
2765
|
+
"security": [],
|
|
2766
|
+
"parameters": [
|
|
2767
|
+
{
|
|
2768
|
+
"name": "key",
|
|
2769
|
+
"in": "path",
|
|
2770
|
+
"required": true,
|
|
2771
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
2772
|
+
"schema": {
|
|
2773
|
+
"type": "string",
|
|
2774
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
2775
|
+
}
|
|
2776
|
+
},
|
|
2777
|
+
{
|
|
2778
|
+
"name": "Origin",
|
|
2779
|
+
"in": "header",
|
|
2780
|
+
"required": true,
|
|
2781
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
2782
|
+
"schema": {
|
|
2783
|
+
"type": "string"
|
|
2784
|
+
}
|
|
2785
|
+
},
|
|
2786
|
+
{
|
|
2787
|
+
"name": "token",
|
|
2788
|
+
"in": "path",
|
|
2789
|
+
"required": true,
|
|
2790
|
+
"description": "Token des Termins aus der Bestätigungs-Mail (32 Hex-Zeichen).",
|
|
2791
|
+
"schema": {
|
|
2792
|
+
"type": "string",
|
|
2793
|
+
"pattern": "^[0-9a-f]{32}$"
|
|
2794
|
+
}
|
|
2795
|
+
}
|
|
2796
|
+
],
|
|
2797
|
+
"responses": {
|
|
2798
|
+
"200": {
|
|
2799
|
+
"description": "Abgesagt.",
|
|
2800
|
+
"content": {
|
|
2801
|
+
"application/json": {
|
|
2802
|
+
"schema": {
|
|
2803
|
+
"$ref": "#/components/schemas/Appointment"
|
|
2804
|
+
},
|
|
2805
|
+
"example": {
|
|
2806
|
+
"data": {
|
|
2807
|
+
"bookingKey": "erstgespraech",
|
|
2808
|
+
"label": "Erstgespräch",
|
|
2809
|
+
"start": "2026-12-01T09:00:00.000Z",
|
|
2810
|
+
"end": "2026-12-01T09:30:00.000Z",
|
|
2811
|
+
"status": "cancelled",
|
|
2812
|
+
"canChange": false
|
|
2813
|
+
}
|
|
2814
|
+
}
|
|
2815
|
+
}
|
|
2816
|
+
}
|
|
2817
|
+
},
|
|
2818
|
+
"403": {
|
|
2819
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
2820
|
+
"content": {
|
|
2821
|
+
"application/json": {
|
|
2822
|
+
"schema": {
|
|
2823
|
+
"$ref": "#/components/schemas/Error"
|
|
2824
|
+
},
|
|
2825
|
+
"example": {
|
|
2826
|
+
"error": "Forbidden",
|
|
2827
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
2828
|
+
"status": 403,
|
|
2829
|
+
"code": "origin_not_allowed"
|
|
2830
|
+
}
|
|
2831
|
+
}
|
|
2832
|
+
}
|
|
2833
|
+
},
|
|
2834
|
+
"404": {
|
|
2835
|
+
"description": "`appointment_not_found`: Token unbekannt, Termin abgesagt oder nicht von dieser Seite.",
|
|
2836
|
+
"content": {
|
|
2837
|
+
"application/json": {
|
|
2838
|
+
"schema": {
|
|
2839
|
+
"$ref": "#/components/schemas/Error"
|
|
2840
|
+
},
|
|
2841
|
+
"example": {
|
|
2842
|
+
"error": "Not Found",
|
|
2843
|
+
"message": "Dieser Link ist ungültig oder abgelaufen.",
|
|
2844
|
+
"status": 404,
|
|
2845
|
+
"code": "appointment_not_found"
|
|
2846
|
+
}
|
|
2847
|
+
}
|
|
2848
|
+
}
|
|
2849
|
+
},
|
|
2850
|
+
"410": {
|
|
2851
|
+
"description": "`appointment_closed`: Termin hat schon begonnen oder ist vorbei.",
|
|
2852
|
+
"content": {
|
|
2853
|
+
"application/json": {
|
|
2854
|
+
"schema": {
|
|
2855
|
+
"$ref": "#/components/schemas/Error"
|
|
2856
|
+
},
|
|
2857
|
+
"example": {
|
|
2858
|
+
"error": "Gone",
|
|
2859
|
+
"message": "Dieser Termin kann nicht mehr abgesagt werden.",
|
|
2860
|
+
"status": 410,
|
|
2861
|
+
"code": "appointment_closed"
|
|
2862
|
+
}
|
|
2863
|
+
}
|
|
2864
|
+
}
|
|
2865
|
+
},
|
|
2866
|
+
"429": {
|
|
2867
|
+
"description": "`rate_limited`: 10/min je IP. Header `Retry-After` (Sekunden).",
|
|
2868
|
+
"content": {
|
|
2869
|
+
"application/json": {
|
|
2870
|
+
"schema": {
|
|
2871
|
+
"$ref": "#/components/schemas/Error"
|
|
2872
|
+
},
|
|
2873
|
+
"example": {
|
|
2874
|
+
"error": "Too Many Requests",
|
|
2875
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
2876
|
+
"status": 429,
|
|
2877
|
+
"code": "rate_limited"
|
|
2878
|
+
}
|
|
2879
|
+
}
|
|
2880
|
+
}
|
|
2881
|
+
}
|
|
2882
|
+
}
|
|
2883
|
+
}
|
|
2884
|
+
},
|
|
2885
|
+
"/s/{key}/appointments/{token}/reschedule": {
|
|
2886
|
+
"post": {
|
|
2887
|
+
"operationId": "rescheduleAppointment",
|
|
2888
|
+
"summary": "Termin verschieben",
|
|
2889
|
+
"description": "Verschiebt auf eine freie Zeit aus `…/slots` (volle Prüfung wie beim Buchen), mit Mail an Gast und Gastgeber. Vorschau: `dryRun`.",
|
|
2890
|
+
"tags": [
|
|
2891
|
+
"Site-API"
|
|
2892
|
+
],
|
|
2893
|
+
"security": [],
|
|
2894
|
+
"parameters": [
|
|
2895
|
+
{
|
|
2896
|
+
"name": "key",
|
|
2897
|
+
"in": "path",
|
|
2898
|
+
"required": true,
|
|
2899
|
+
"description": "Publishable Key der Seite (`dsp_…`, öffentlich).",
|
|
2900
|
+
"schema": {
|
|
2901
|
+
"type": "string",
|
|
2902
|
+
"pattern": "^dsp_[0-9a-hjkmnp-tv-z]{8}_[A-Za-z0-9_-]{24}$"
|
|
2903
|
+
}
|
|
2904
|
+
},
|
|
2905
|
+
{
|
|
2906
|
+
"name": "Origin",
|
|
2907
|
+
"in": "header",
|
|
2908
|
+
"required": true,
|
|
2909
|
+
"description": "Vom Browser gesetzt. Muss eine Domain der Seite sein.",
|
|
2910
|
+
"schema": {
|
|
2911
|
+
"type": "string"
|
|
2912
|
+
}
|
|
2913
|
+
},
|
|
2914
|
+
{
|
|
2915
|
+
"name": "token",
|
|
2916
|
+
"in": "path",
|
|
2917
|
+
"required": true,
|
|
2918
|
+
"description": "Token des Termins aus der Bestätigungs-Mail (32 Hex-Zeichen).",
|
|
2919
|
+
"schema": {
|
|
2920
|
+
"type": "string",
|
|
2921
|
+
"pattern": "^[0-9a-f]{32}$"
|
|
2922
|
+
}
|
|
2923
|
+
}
|
|
2924
|
+
],
|
|
2925
|
+
"requestBody": {
|
|
2926
|
+
"required": true,
|
|
2927
|
+
"content": {
|
|
2928
|
+
"application/json": {
|
|
2929
|
+
"schema": {
|
|
2930
|
+
"type": "object",
|
|
2931
|
+
"properties": {
|
|
2932
|
+
"start": {
|
|
2933
|
+
"type": "string",
|
|
2934
|
+
"maxLength": 40,
|
|
2935
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})$",
|
|
2936
|
+
"description": "Beginn als ISO-Zeitpunkt mit Zone, am besten genau `start` aus `…/slots` (UTC)."
|
|
2937
|
+
}
|
|
2938
|
+
},
|
|
2939
|
+
"required": [
|
|
2940
|
+
"start"
|
|
2941
|
+
],
|
|
2942
|
+
"additionalProperties": false
|
|
2943
|
+
},
|
|
2944
|
+
"example": {
|
|
2945
|
+
"start": "2026-12-02T10:00:00.000Z"
|
|
2946
|
+
}
|
|
2947
|
+
}
|
|
2948
|
+
}
|
|
2949
|
+
},
|
|
2950
|
+
"responses": {
|
|
2951
|
+
"200": {
|
|
2952
|
+
"description": "Verschoben.",
|
|
2953
|
+
"content": {
|
|
2954
|
+
"application/json": {
|
|
2955
|
+
"schema": {
|
|
2956
|
+
"$ref": "#/components/schemas/Appointment"
|
|
2957
|
+
},
|
|
2958
|
+
"example": {
|
|
2959
|
+
"data": {
|
|
2960
|
+
"bookingKey": "erstgespraech",
|
|
2961
|
+
"label": "Erstgespräch",
|
|
2962
|
+
"start": "2026-12-02T10:00:00.000Z",
|
|
2963
|
+
"end": "2026-12-02T10:30:00.000Z",
|
|
2964
|
+
"status": "booked",
|
|
2965
|
+
"canChange": true,
|
|
2966
|
+
"token": "9f2c4e6a8b0d1f3a5c7e9b1d3f5a7c9e"
|
|
2967
|
+
}
|
|
2968
|
+
}
|
|
2969
|
+
}
|
|
2970
|
+
}
|
|
2971
|
+
},
|
|
2972
|
+
"403": {
|
|
2973
|
+
"description": "`origin_not_allowed`: `Origin` fehlt oder gehört nicht zur Seite (aktive Domain, Standard-Host, Vorschau-Host einer gebauten Version). Ohne CORS-Header.",
|
|
2974
|
+
"content": {
|
|
2975
|
+
"application/json": {
|
|
2976
|
+
"schema": {
|
|
2977
|
+
"$ref": "#/components/schemas/Error"
|
|
2978
|
+
},
|
|
2979
|
+
"example": {
|
|
2980
|
+
"error": "Forbidden",
|
|
2981
|
+
"message": "Anfragen sind nur von den Domains dieser Website erlaubt.",
|
|
2982
|
+
"status": 403,
|
|
2983
|
+
"code": "origin_not_allowed"
|
|
2984
|
+
}
|
|
2985
|
+
}
|
|
2986
|
+
}
|
|
2987
|
+
},
|
|
2988
|
+
"404": {
|
|
2989
|
+
"description": "`appointment_not_found`: Token unbekannt, Termin abgesagt oder nicht von dieser Seite.",
|
|
2990
|
+
"content": {
|
|
2991
|
+
"application/json": {
|
|
2992
|
+
"schema": {
|
|
2993
|
+
"$ref": "#/components/schemas/Error"
|
|
2994
|
+
},
|
|
2995
|
+
"example": {
|
|
2996
|
+
"error": "Not Found",
|
|
2997
|
+
"message": "Dieser Link ist ungültig oder abgelaufen.",
|
|
2998
|
+
"status": 404,
|
|
2999
|
+
"code": "appointment_not_found"
|
|
3000
|
+
}
|
|
3001
|
+
}
|
|
3002
|
+
}
|
|
3003
|
+
},
|
|
3004
|
+
"409": {
|
|
3005
|
+
"description": "`slot_taken`: die Zeit ist inzwischen vergeben oder nicht (mehr) buchbar — freie Zeiten neu laden.",
|
|
3006
|
+
"content": {
|
|
3007
|
+
"application/json": {
|
|
3008
|
+
"schema": {
|
|
3009
|
+
"$ref": "#/components/schemas/Error"
|
|
3010
|
+
},
|
|
3011
|
+
"example": {
|
|
3012
|
+
"error": "Conflict",
|
|
3013
|
+
"message": "Diese Zeit ist nicht (mehr) frei. Bitte wähle eine andere.",
|
|
3014
|
+
"status": 409,
|
|
3015
|
+
"code": "slot_taken"
|
|
3016
|
+
}
|
|
3017
|
+
}
|
|
3018
|
+
}
|
|
3019
|
+
},
|
|
3020
|
+
"410": {
|
|
3021
|
+
"description": "`appointment_closed`: Termin hat schon begonnen oder ist vorbei.",
|
|
3022
|
+
"content": {
|
|
3023
|
+
"application/json": {
|
|
3024
|
+
"schema": {
|
|
3025
|
+
"$ref": "#/components/schemas/Error"
|
|
3026
|
+
},
|
|
3027
|
+
"example": {
|
|
3028
|
+
"error": "Gone",
|
|
3029
|
+
"message": "Dieser Termin kann nicht mehr verschoben werden.",
|
|
3030
|
+
"status": 410,
|
|
3031
|
+
"code": "appointment_closed"
|
|
3032
|
+
}
|
|
3033
|
+
}
|
|
3034
|
+
}
|
|
3035
|
+
},
|
|
3036
|
+
"422": {
|
|
3037
|
+
"description": "`validation_error`: `start` fehlt oder ist kein Zeitpunkt.",
|
|
3038
|
+
"content": {
|
|
3039
|
+
"application/json": {
|
|
3040
|
+
"schema": {
|
|
3041
|
+
"$ref": "#/components/schemas/Error"
|
|
3042
|
+
}
|
|
3043
|
+
}
|
|
3044
|
+
}
|
|
3045
|
+
},
|
|
3046
|
+
"429": {
|
|
3047
|
+
"description": "`rate_limited`: 10/min je IP. Header `Retry-After` (Sekunden).",
|
|
3048
|
+
"content": {
|
|
3049
|
+
"application/json": {
|
|
3050
|
+
"schema": {
|
|
3051
|
+
"$ref": "#/components/schemas/Error"
|
|
3052
|
+
},
|
|
3053
|
+
"example": {
|
|
3054
|
+
"error": "Too Many Requests",
|
|
3055
|
+
"message": "Zu viele Anfragen. Bitte später erneut versuchen.",
|
|
3056
|
+
"status": 429,
|
|
3057
|
+
"code": "rate_limited"
|
|
3058
|
+
}
|
|
3059
|
+
}
|
|
3060
|
+
}
|
|
3061
|
+
}
|
|
3062
|
+
}
|
|
3063
|
+
}
|
|
3064
|
+
}
|
|
3065
|
+
},
|
|
3066
|
+
"components": {
|
|
3067
|
+
"schemas": {
|
|
3068
|
+
"CaptchaChallenge": {
|
|
3069
|
+
"type": "object",
|
|
3070
|
+
"properties": {
|
|
3071
|
+
"parameters": {
|
|
3072
|
+
"type": "object",
|
|
3073
|
+
"properties": {
|
|
3074
|
+
"algorithm": {
|
|
3075
|
+
"type": "string",
|
|
3076
|
+
"const": "PBKDF2/SHA-256"
|
|
3077
|
+
},
|
|
3078
|
+
"cost": {
|
|
3079
|
+
"type": "number",
|
|
3080
|
+
"const": 2000,
|
|
3081
|
+
"description": "PBKDF2-Iterationen je Versuch."
|
|
3082
|
+
},
|
|
3083
|
+
"data": {
|
|
3084
|
+
"type": "object",
|
|
3085
|
+
"properties": {
|
|
3086
|
+
"site": {
|
|
3087
|
+
"type": "string",
|
|
3088
|
+
"format": "uuid",
|
|
3089
|
+
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
|
|
3090
|
+
}
|
|
3091
|
+
},
|
|
3092
|
+
"required": [
|
|
3093
|
+
"site"
|
|
3094
|
+
],
|
|
3095
|
+
"additionalProperties": false,
|
|
3096
|
+
"description": "Seite, für die die Challenge gilt (signiert)."
|
|
3097
|
+
},
|
|
3098
|
+
"expiresAt": {
|
|
3099
|
+
"type": "integer",
|
|
3100
|
+
"minimum": -9007199254740991,
|
|
3101
|
+
"maximum": 9007199254740991,
|
|
3102
|
+
"description": "Ablauf in Unix-Sekunden (10 Minuten)."
|
|
3103
|
+
},
|
|
3104
|
+
"keyLength": {
|
|
3105
|
+
"type": "number",
|
|
3106
|
+
"const": 32
|
|
3107
|
+
},
|
|
3108
|
+
"keyPrefix": {
|
|
3109
|
+
"type": "string",
|
|
3110
|
+
"pattern": "^[0-9a-f]{32}$",
|
|
3111
|
+
"description": "Präfix des gesuchten Schlüssels."
|
|
3112
|
+
},
|
|
3113
|
+
"keySignature": {
|
|
3114
|
+
"type": "string",
|
|
3115
|
+
"pattern": "^[0-9a-f]{64}$"
|
|
3116
|
+
},
|
|
3117
|
+
"nonce": {
|
|
3118
|
+
"type": "string",
|
|
3119
|
+
"pattern": "^[0-9a-f]{32}$"
|
|
3120
|
+
},
|
|
3121
|
+
"salt": {
|
|
3122
|
+
"type": "string",
|
|
3123
|
+
"pattern": "^[0-9a-f]{32}$"
|
|
3124
|
+
}
|
|
3125
|
+
},
|
|
3126
|
+
"required": [
|
|
3127
|
+
"algorithm",
|
|
3128
|
+
"cost",
|
|
3129
|
+
"data",
|
|
3130
|
+
"expiresAt",
|
|
3131
|
+
"keyLength",
|
|
3132
|
+
"keyPrefix",
|
|
3133
|
+
"keySignature",
|
|
3134
|
+
"nonce",
|
|
3135
|
+
"salt"
|
|
3136
|
+
],
|
|
3137
|
+
"additionalProperties": false
|
|
3138
|
+
},
|
|
3139
|
+
"signature": {
|
|
3140
|
+
"type": "string",
|
|
3141
|
+
"pattern": "^[0-9a-f]{64}$",
|
|
3142
|
+
"description": "HMAC-SHA-256 über die Parameter."
|
|
3143
|
+
}
|
|
3144
|
+
},
|
|
3145
|
+
"required": [
|
|
3146
|
+
"parameters",
|
|
3147
|
+
"signature"
|
|
3148
|
+
],
|
|
3149
|
+
"additionalProperties": false,
|
|
3150
|
+
"description": "ALTCHA-Challenge (v3, wie `altcha-lib` sie erzeugt). Bewusste Ausnahme vom `{ data }`-Muster: das ALTCHA-Widget liest die Antwort seiner `challengeurl` unverändert; eine Hülle müsste jede Seite selbst auspacken. Gültig 10 Minuten, eine Lösung gilt für genau eine Einsendung dieser Seite."
|
|
3151
|
+
},
|
|
3152
|
+
"Error": {
|
|
3153
|
+
"type": "object",
|
|
3154
|
+
"properties": {
|
|
3155
|
+
"error": {
|
|
3156
|
+
"type": "string",
|
|
3157
|
+
"description": "HTTP-Statustext. Den Grund trägt `code`."
|
|
3158
|
+
},
|
|
3159
|
+
"message": {
|
|
3160
|
+
"type": "string",
|
|
3161
|
+
"description": "Deutscher Text, zum Anzeigen geeignet."
|
|
3162
|
+
},
|
|
3163
|
+
"status": {
|
|
3164
|
+
"type": "integer",
|
|
3165
|
+
"minimum": -9007199254740991,
|
|
3166
|
+
"maximum": 9007199254740991
|
|
3167
|
+
},
|
|
3168
|
+
"code": {
|
|
3169
|
+
"type": "string",
|
|
3170
|
+
"enum": [
|
|
3171
|
+
"invalid_json",
|
|
3172
|
+
"captcha_failed",
|
|
3173
|
+
"origin_not_allowed",
|
|
3174
|
+
"not_found",
|
|
3175
|
+
"site_not_found",
|
|
3176
|
+
"funnel_not_found",
|
|
3177
|
+
"method_not_allowed",
|
|
3178
|
+
"unsupported_media_type",
|
|
3179
|
+
"payload_too_large",
|
|
3180
|
+
"validation_error",
|
|
3181
|
+
"rate_limited",
|
|
3182
|
+
"internal_error",
|
|
3183
|
+
"captcha_unavailable",
|
|
3184
|
+
"booking_unavailable",
|
|
3185
|
+
"slot_taken",
|
|
3186
|
+
"slots_unavailable",
|
|
3187
|
+
"invalid_range",
|
|
3188
|
+
"invalid_timezone",
|
|
3189
|
+
"not_qualified",
|
|
3190
|
+
"appointment_not_found",
|
|
3191
|
+
"appointment_closed"
|
|
3192
|
+
]
|
|
3193
|
+
},
|
|
3194
|
+
"details": {
|
|
3195
|
+
"description": "Nur bei 422: Feldpfade (`data.email`, `submissionId`) und Grund.",
|
|
3196
|
+
"type": "array",
|
|
3197
|
+
"items": {
|
|
3198
|
+
"type": "object",
|
|
3199
|
+
"properties": {
|
|
3200
|
+
"path": {
|
|
3201
|
+
"type": "string"
|
|
3202
|
+
},
|
|
3203
|
+
"message": {
|
|
3204
|
+
"type": "string"
|
|
3205
|
+
}
|
|
3206
|
+
},
|
|
3207
|
+
"required": [
|
|
3208
|
+
"path",
|
|
3209
|
+
"message"
|
|
3210
|
+
],
|
|
3211
|
+
"additionalProperties": false
|
|
3212
|
+
}
|
|
3213
|
+
}
|
|
3214
|
+
},
|
|
3215
|
+
"required": [
|
|
3216
|
+
"error",
|
|
3217
|
+
"message",
|
|
3218
|
+
"status",
|
|
3219
|
+
"code"
|
|
3220
|
+
],
|
|
3221
|
+
"additionalProperties": false,
|
|
3222
|
+
"description": "Fehlerform aller Endpunkte der Site-API."
|
|
3223
|
+
},
|
|
3224
|
+
"LeadAccepted": {
|
|
3225
|
+
"type": "object",
|
|
3226
|
+
"properties": {
|
|
3227
|
+
"data": {
|
|
3228
|
+
"type": "object",
|
|
3229
|
+
"properties": {
|
|
3230
|
+
"accepted": {
|
|
3231
|
+
"type": "boolean",
|
|
3232
|
+
"const": true
|
|
3233
|
+
},
|
|
3234
|
+
"dryRun": {
|
|
3235
|
+
"description": "Nur aus der Vorschau: geprüft, aber nichts gespeichert.",
|
|
3236
|
+
"type": "boolean",
|
|
3237
|
+
"const": true
|
|
3238
|
+
}
|
|
3239
|
+
},
|
|
3240
|
+
"required": [
|
|
3241
|
+
"accepted"
|
|
3242
|
+
],
|
|
3243
|
+
"additionalProperties": false
|
|
3244
|
+
}
|
|
3245
|
+
},
|
|
3246
|
+
"required": [
|
|
3247
|
+
"data"
|
|
3248
|
+
],
|
|
3249
|
+
"additionalProperties": false,
|
|
3250
|
+
"description": "Angenommen. Enthält bewusst keine Kontakt- oder Deal-ID. Nie eine Erfolgsmeldung anzeigen ohne `accepted: true`."
|
|
3251
|
+
},
|
|
3252
|
+
"PageviewAccepted": {
|
|
3253
|
+
"type": "object",
|
|
3254
|
+
"properties": {
|
|
3255
|
+
"data": {
|
|
3256
|
+
"type": "object",
|
|
3257
|
+
"properties": {
|
|
3258
|
+
"accepted": {
|
|
3259
|
+
"type": "boolean",
|
|
3260
|
+
"const": true
|
|
3261
|
+
},
|
|
3262
|
+
"dryRun": {
|
|
3263
|
+
"description": "Nur aus der Vorschau: geprüft, aber nichts gezählt.",
|
|
3264
|
+
"type": "boolean",
|
|
3265
|
+
"const": true
|
|
3266
|
+
}
|
|
3267
|
+
},
|
|
3268
|
+
"required": [
|
|
3269
|
+
"accepted"
|
|
3270
|
+
],
|
|
3271
|
+
"additionalProperties": false
|
|
3272
|
+
}
|
|
3273
|
+
},
|
|
3274
|
+
"required": [
|
|
3275
|
+
"data"
|
|
3276
|
+
],
|
|
3277
|
+
"additionalProperties": false,
|
|
3278
|
+
"description": "Angenommen (oder als Bot still verworfen). Enthält keine IDs."
|
|
3279
|
+
},
|
|
3280
|
+
"CollectionList": {
|
|
3281
|
+
"type": "object",
|
|
3282
|
+
"properties": {
|
|
3283
|
+
"data": {
|
|
3284
|
+
"type": "array",
|
|
3285
|
+
"items": {
|
|
3286
|
+
"type": "object",
|
|
3287
|
+
"properties": {
|
|
3288
|
+
"slug": {
|
|
3289
|
+
"type": "string"
|
|
3290
|
+
},
|
|
3291
|
+
"publishedAt": {
|
|
3292
|
+
"type": "string",
|
|
3293
|
+
"description": "ISO-Zeitpunkt der Veröffentlichung."
|
|
3294
|
+
},
|
|
3295
|
+
"data": {
|
|
3296
|
+
"type": "object",
|
|
3297
|
+
"propertyNames": {
|
|
3298
|
+
"type": "string"
|
|
3299
|
+
},
|
|
3300
|
+
"additionalProperties": {},
|
|
3301
|
+
"description": "Werte je Feld des Schemas aus `dealsystem.config.ts`, ohne Medienfelder. Richtext-Felder sind bereinigtes HTML (keine Bilder, keine Einbettungen, keine Stile) — nicht noch einmal als Markdown rendern."
|
|
3302
|
+
},
|
|
3303
|
+
"media": {
|
|
3304
|
+
"type": "object",
|
|
3305
|
+
"propertyNames": {
|
|
3306
|
+
"type": "string"
|
|
3307
|
+
},
|
|
3308
|
+
"additionalProperties": {
|
|
3309
|
+
"type": "array",
|
|
3310
|
+
"items": {
|
|
3311
|
+
"type": "object",
|
|
3312
|
+
"properties": {
|
|
3313
|
+
"id": {
|
|
3314
|
+
"type": "string",
|
|
3315
|
+
"description": "Kennung des Mediums (stabil)."
|
|
3316
|
+
},
|
|
3317
|
+
"kind": {
|
|
3318
|
+
"type": "string",
|
|
3319
|
+
"enum": [
|
|
3320
|
+
"image",
|
|
3321
|
+
"video",
|
|
3322
|
+
"file"
|
|
3323
|
+
]
|
|
3324
|
+
},
|
|
3325
|
+
"alt": {
|
|
3326
|
+
"type": "string",
|
|
3327
|
+
"description": "Alternativtext aus dem CMS. Leer = dekorativ."
|
|
3328
|
+
},
|
|
3329
|
+
"width": {
|
|
3330
|
+
"anyOf": [
|
|
3331
|
+
{
|
|
3332
|
+
"type": "integer",
|
|
3333
|
+
"minimum": -9007199254740991,
|
|
3334
|
+
"maximum": 9007199254740991
|
|
3335
|
+
},
|
|
3336
|
+
{
|
|
3337
|
+
"type": "null"
|
|
3338
|
+
}
|
|
3339
|
+
],
|
|
3340
|
+
"description": "Pixelbreite des größten Bildes; bei Dateien `null`."
|
|
3341
|
+
},
|
|
3342
|
+
"height": {
|
|
3343
|
+
"anyOf": [
|
|
3344
|
+
{
|
|
3345
|
+
"type": "integer",
|
|
3346
|
+
"minimum": -9007199254740991,
|
|
3347
|
+
"maximum": 9007199254740991
|
|
3348
|
+
},
|
|
3349
|
+
{
|
|
3350
|
+
"type": "null"
|
|
3351
|
+
}
|
|
3352
|
+
]
|
|
3353
|
+
},
|
|
3354
|
+
"variants": {
|
|
3355
|
+
"type": "array",
|
|
3356
|
+
"items": {
|
|
3357
|
+
"type": "object",
|
|
3358
|
+
"properties": {
|
|
3359
|
+
"url": {
|
|
3360
|
+
"type": "string",
|
|
3361
|
+
"description": "Dauerhafte, seitenrelative URL `/_ds/media/<siteId>/<id>/<variante>.<endung>` — vom selben Origin wie die Seite."
|
|
3362
|
+
},
|
|
3363
|
+
"width": {
|
|
3364
|
+
"type": "integer",
|
|
3365
|
+
"minimum": -9007199254740991,
|
|
3366
|
+
"maximum": 9007199254740991
|
|
3367
|
+
},
|
|
3368
|
+
"format": {
|
|
3369
|
+
"type": "string",
|
|
3370
|
+
"enum": [
|
|
3371
|
+
"jpeg",
|
|
3372
|
+
"webp",
|
|
3373
|
+
"avif"
|
|
3374
|
+
]
|
|
3375
|
+
}
|
|
3376
|
+
},
|
|
3377
|
+
"required": [
|
|
3378
|
+
"url",
|
|
3379
|
+
"width",
|
|
3380
|
+
"format"
|
|
3381
|
+
],
|
|
3382
|
+
"additionalProperties": false
|
|
3383
|
+
},
|
|
3384
|
+
"description": "Bildgrößen, nach Breite aufsteigend. Phase 1: JPEG; WebP/AVIF kommen später dazu."
|
|
3385
|
+
},
|
|
3386
|
+
"video": {
|
|
3387
|
+
"description": "Phase 2.",
|
|
3388
|
+
"type": "object",
|
|
3389
|
+
"properties": {
|
|
3390
|
+
"provider": {
|
|
3391
|
+
"type": "string",
|
|
3392
|
+
"const": "bunny"
|
|
3393
|
+
},
|
|
3394
|
+
"playbackUrl": {
|
|
3395
|
+
"type": "string"
|
|
3396
|
+
},
|
|
3397
|
+
"posterUrl": {
|
|
3398
|
+
"type": "string"
|
|
3399
|
+
}
|
|
3400
|
+
},
|
|
3401
|
+
"required": [
|
|
3402
|
+
"provider",
|
|
3403
|
+
"playbackUrl",
|
|
3404
|
+
"posterUrl"
|
|
3405
|
+
],
|
|
3406
|
+
"additionalProperties": false
|
|
3407
|
+
},
|
|
3408
|
+
"url": {
|
|
3409
|
+
"description": "Nur bei `kind: \"file\"`: dauerhafte, seitenrelative URL.",
|
|
3410
|
+
"type": "string"
|
|
3411
|
+
}
|
|
3412
|
+
},
|
|
3413
|
+
"required": [
|
|
3414
|
+
"id",
|
|
3415
|
+
"kind",
|
|
3416
|
+
"alt",
|
|
3417
|
+
"width",
|
|
3418
|
+
"height",
|
|
3419
|
+
"variants"
|
|
3420
|
+
],
|
|
3421
|
+
"additionalProperties": false,
|
|
3422
|
+
"description": "Öffentliches Medium (Bild, Datei). Keine signierten, ablaufenden Links."
|
|
3423
|
+
}
|
|
3424
|
+
},
|
|
3425
|
+
"description": "Je Bild-, Galerie- oder Dateifeld die Medien in der Reihenfolge des CMS — auch in der Liste."
|
|
3426
|
+
}
|
|
3427
|
+
},
|
|
3428
|
+
"required": [
|
|
3429
|
+
"slug",
|
|
3430
|
+
"publishedAt",
|
|
3431
|
+
"data",
|
|
3432
|
+
"media"
|
|
3433
|
+
],
|
|
3434
|
+
"additionalProperties": false,
|
|
3435
|
+
"description": "Ein veröffentlichter Eintrag. Entwürfe gibt es hier nie."
|
|
3436
|
+
}
|
|
3437
|
+
},
|
|
3438
|
+
"meta": {
|
|
3439
|
+
"type": "object",
|
|
3440
|
+
"properties": {
|
|
3441
|
+
"total": {
|
|
3442
|
+
"type": "integer",
|
|
3443
|
+
"minimum": -9007199254740991,
|
|
3444
|
+
"maximum": 9007199254740991,
|
|
3445
|
+
"description": "Zahl der veröffentlichten Einträge der Sammlung."
|
|
3446
|
+
},
|
|
3447
|
+
"limit": {
|
|
3448
|
+
"type": "integer",
|
|
3449
|
+
"minimum": -9007199254740991,
|
|
3450
|
+
"maximum": 9007199254740991
|
|
3451
|
+
},
|
|
3452
|
+
"offset": {
|
|
3453
|
+
"type": "integer",
|
|
3454
|
+
"minimum": -9007199254740991,
|
|
3455
|
+
"maximum": 9007199254740991
|
|
3456
|
+
}
|
|
3457
|
+
},
|
|
3458
|
+
"required": [
|
|
3459
|
+
"total",
|
|
3460
|
+
"limit",
|
|
3461
|
+
"offset"
|
|
3462
|
+
],
|
|
3463
|
+
"additionalProperties": false
|
|
3464
|
+
}
|
|
3465
|
+
},
|
|
3466
|
+
"required": [
|
|
3467
|
+
"data",
|
|
3468
|
+
"meta"
|
|
3469
|
+
],
|
|
3470
|
+
"additionalProperties": false
|
|
3471
|
+
},
|
|
3472
|
+
"CollectionEntry": {
|
|
3473
|
+
"type": "object",
|
|
3474
|
+
"properties": {
|
|
3475
|
+
"data": {
|
|
3476
|
+
"type": "object",
|
|
3477
|
+
"properties": {
|
|
3478
|
+
"slug": {
|
|
3479
|
+
"type": "string"
|
|
3480
|
+
},
|
|
3481
|
+
"publishedAt": {
|
|
3482
|
+
"type": "string",
|
|
3483
|
+
"description": "ISO-Zeitpunkt der Veröffentlichung."
|
|
3484
|
+
},
|
|
3485
|
+
"data": {
|
|
3486
|
+
"type": "object",
|
|
3487
|
+
"propertyNames": {
|
|
3488
|
+
"type": "string"
|
|
3489
|
+
},
|
|
3490
|
+
"additionalProperties": {},
|
|
3491
|
+
"description": "Werte je Feld des Schemas aus `dealsystem.config.ts`, ohne Medienfelder. Richtext-Felder sind bereinigtes HTML (keine Bilder, keine Einbettungen, keine Stile) — nicht noch einmal als Markdown rendern."
|
|
3492
|
+
},
|
|
3493
|
+
"media": {
|
|
3494
|
+
"type": "object",
|
|
3495
|
+
"propertyNames": {
|
|
3496
|
+
"type": "string"
|
|
3497
|
+
},
|
|
3498
|
+
"additionalProperties": {
|
|
3499
|
+
"type": "array",
|
|
3500
|
+
"items": {
|
|
3501
|
+
"type": "object",
|
|
3502
|
+
"properties": {
|
|
3503
|
+
"id": {
|
|
3504
|
+
"type": "string",
|
|
3505
|
+
"description": "Kennung des Mediums (stabil)."
|
|
3506
|
+
},
|
|
3507
|
+
"kind": {
|
|
3508
|
+
"type": "string",
|
|
3509
|
+
"enum": [
|
|
3510
|
+
"image",
|
|
3511
|
+
"video",
|
|
3512
|
+
"file"
|
|
3513
|
+
]
|
|
3514
|
+
},
|
|
3515
|
+
"alt": {
|
|
3516
|
+
"type": "string",
|
|
3517
|
+
"description": "Alternativtext aus dem CMS. Leer = dekorativ."
|
|
3518
|
+
},
|
|
3519
|
+
"width": {
|
|
3520
|
+
"anyOf": [
|
|
3521
|
+
{
|
|
3522
|
+
"type": "integer",
|
|
3523
|
+
"minimum": -9007199254740991,
|
|
3524
|
+
"maximum": 9007199254740991
|
|
3525
|
+
},
|
|
3526
|
+
{
|
|
3527
|
+
"type": "null"
|
|
3528
|
+
}
|
|
3529
|
+
],
|
|
3530
|
+
"description": "Pixelbreite des größten Bildes; bei Dateien `null`."
|
|
3531
|
+
},
|
|
3532
|
+
"height": {
|
|
3533
|
+
"anyOf": [
|
|
3534
|
+
{
|
|
3535
|
+
"type": "integer",
|
|
3536
|
+
"minimum": -9007199254740991,
|
|
3537
|
+
"maximum": 9007199254740991
|
|
3538
|
+
},
|
|
3539
|
+
{
|
|
3540
|
+
"type": "null"
|
|
3541
|
+
}
|
|
3542
|
+
]
|
|
3543
|
+
},
|
|
3544
|
+
"variants": {
|
|
3545
|
+
"type": "array",
|
|
3546
|
+
"items": {
|
|
3547
|
+
"type": "object",
|
|
3548
|
+
"properties": {
|
|
3549
|
+
"url": {
|
|
3550
|
+
"type": "string",
|
|
3551
|
+
"description": "Dauerhafte, seitenrelative URL `/_ds/media/<siteId>/<id>/<variante>.<endung>` — vom selben Origin wie die Seite."
|
|
3552
|
+
},
|
|
3553
|
+
"width": {
|
|
3554
|
+
"type": "integer",
|
|
3555
|
+
"minimum": -9007199254740991,
|
|
3556
|
+
"maximum": 9007199254740991
|
|
3557
|
+
},
|
|
3558
|
+
"format": {
|
|
3559
|
+
"type": "string",
|
|
3560
|
+
"enum": [
|
|
3561
|
+
"jpeg",
|
|
3562
|
+
"webp",
|
|
3563
|
+
"avif"
|
|
3564
|
+
]
|
|
3565
|
+
}
|
|
3566
|
+
},
|
|
3567
|
+
"required": [
|
|
3568
|
+
"url",
|
|
3569
|
+
"width",
|
|
3570
|
+
"format"
|
|
3571
|
+
],
|
|
3572
|
+
"additionalProperties": false
|
|
3573
|
+
},
|
|
3574
|
+
"description": "Bildgrößen, nach Breite aufsteigend. Phase 1: JPEG; WebP/AVIF kommen später dazu."
|
|
3575
|
+
},
|
|
3576
|
+
"video": {
|
|
3577
|
+
"description": "Phase 2.",
|
|
3578
|
+
"type": "object",
|
|
3579
|
+
"properties": {
|
|
3580
|
+
"provider": {
|
|
3581
|
+
"type": "string",
|
|
3582
|
+
"const": "bunny"
|
|
3583
|
+
},
|
|
3584
|
+
"playbackUrl": {
|
|
3585
|
+
"type": "string"
|
|
3586
|
+
},
|
|
3587
|
+
"posterUrl": {
|
|
3588
|
+
"type": "string"
|
|
3589
|
+
}
|
|
3590
|
+
},
|
|
3591
|
+
"required": [
|
|
3592
|
+
"provider",
|
|
3593
|
+
"playbackUrl",
|
|
3594
|
+
"posterUrl"
|
|
3595
|
+
],
|
|
3596
|
+
"additionalProperties": false
|
|
3597
|
+
},
|
|
3598
|
+
"url": {
|
|
3599
|
+
"description": "Nur bei `kind: \"file\"`: dauerhafte, seitenrelative URL.",
|
|
3600
|
+
"type": "string"
|
|
3601
|
+
}
|
|
3602
|
+
},
|
|
3603
|
+
"required": [
|
|
3604
|
+
"id",
|
|
3605
|
+
"kind",
|
|
3606
|
+
"alt",
|
|
3607
|
+
"width",
|
|
3608
|
+
"height",
|
|
3609
|
+
"variants"
|
|
3610
|
+
],
|
|
3611
|
+
"additionalProperties": false,
|
|
3612
|
+
"description": "Öffentliches Medium (Bild, Datei). Keine signierten, ablaufenden Links."
|
|
3613
|
+
}
|
|
3614
|
+
},
|
|
3615
|
+
"description": "Je Bild-, Galerie- oder Dateifeld die Medien in der Reihenfolge des CMS — auch in der Liste."
|
|
3616
|
+
}
|
|
3617
|
+
},
|
|
3618
|
+
"required": [
|
|
3619
|
+
"slug",
|
|
3620
|
+
"publishedAt",
|
|
3621
|
+
"data",
|
|
3622
|
+
"media"
|
|
3623
|
+
],
|
|
3624
|
+
"additionalProperties": false,
|
|
3625
|
+
"description": "Ein veröffentlichter Eintrag. Entwürfe gibt es hier nie."
|
|
3626
|
+
}
|
|
3627
|
+
},
|
|
3628
|
+
"required": [
|
|
3629
|
+
"data"
|
|
3630
|
+
],
|
|
3631
|
+
"additionalProperties": false
|
|
3632
|
+
},
|
|
3633
|
+
"BookingInfo": {
|
|
3634
|
+
"type": "object",
|
|
3635
|
+
"properties": {
|
|
3636
|
+
"data": {
|
|
3637
|
+
"type": "object",
|
|
3638
|
+
"properties": {
|
|
3639
|
+
"key": {
|
|
3640
|
+
"type": "string"
|
|
3641
|
+
},
|
|
3642
|
+
"label": {
|
|
3643
|
+
"type": "string",
|
|
3644
|
+
"description": "Bezeichnung aus dem Code, sonst der Name der Terminart."
|
|
3645
|
+
},
|
|
3646
|
+
"title": {
|
|
3647
|
+
"type": "string",
|
|
3648
|
+
"description": "Name der Terminart im CRM."
|
|
3649
|
+
},
|
|
3650
|
+
"description": {
|
|
3651
|
+
"type": [
|
|
3652
|
+
"string",
|
|
3653
|
+
"null"
|
|
3654
|
+
]
|
|
3655
|
+
},
|
|
3656
|
+
"durationMinutes": {
|
|
3657
|
+
"type": "integer",
|
|
3658
|
+
"minimum": -9007199254740991,
|
|
3659
|
+
"maximum": 9007199254740991
|
|
3660
|
+
},
|
|
3661
|
+
"timezone": {
|
|
3662
|
+
"type": "string",
|
|
3663
|
+
"description": "IANA-Zeitzone des Kalenders."
|
|
3664
|
+
},
|
|
3665
|
+
"locations": {
|
|
3666
|
+
"type": "array",
|
|
3667
|
+
"items": {
|
|
3668
|
+
"type": "object",
|
|
3669
|
+
"properties": {
|
|
3670
|
+
"type": {
|
|
3671
|
+
"type": "string",
|
|
3672
|
+
"enum": [
|
|
3673
|
+
"google_meet",
|
|
3674
|
+
"in_person",
|
|
3675
|
+
"phone",
|
|
3676
|
+
"link"
|
|
3677
|
+
]
|
|
3678
|
+
},
|
|
3679
|
+
"label": {
|
|
3680
|
+
"type": "string"
|
|
3681
|
+
}
|
|
3682
|
+
},
|
|
3683
|
+
"required": [
|
|
3684
|
+
"type",
|
|
3685
|
+
"label"
|
|
3686
|
+
],
|
|
3687
|
+
"additionalProperties": false
|
|
3688
|
+
},
|
|
3689
|
+
"description": "Ort-Arten ohne Adresse, Telefonnummer oder Link des Gastgebers."
|
|
3690
|
+
},
|
|
3691
|
+
"questions": {
|
|
3692
|
+
"type": "array",
|
|
3693
|
+
"items": {
|
|
3694
|
+
"type": "object",
|
|
3695
|
+
"properties": {
|
|
3696
|
+
"key": {
|
|
3697
|
+
"type": "string"
|
|
3698
|
+
},
|
|
3699
|
+
"label": {
|
|
3700
|
+
"type": "string"
|
|
3701
|
+
},
|
|
3702
|
+
"type": {
|
|
3703
|
+
"type": "string"
|
|
3704
|
+
},
|
|
3705
|
+
"required": {
|
|
3706
|
+
"type": "boolean"
|
|
3707
|
+
},
|
|
3708
|
+
"options": {
|
|
3709
|
+
"anyOf": [
|
|
3710
|
+
{
|
|
3711
|
+
"type": "array",
|
|
3712
|
+
"items": {
|
|
3713
|
+
"type": "string"
|
|
3714
|
+
}
|
|
3715
|
+
},
|
|
3716
|
+
{
|
|
3717
|
+
"type": "null"
|
|
3718
|
+
}
|
|
3719
|
+
]
|
|
3720
|
+
},
|
|
3721
|
+
"placeholder": {
|
|
3722
|
+
"type": [
|
|
3723
|
+
"string",
|
|
3724
|
+
"null"
|
|
3725
|
+
]
|
|
3726
|
+
}
|
|
3727
|
+
},
|
|
3728
|
+
"required": [
|
|
3729
|
+
"key",
|
|
3730
|
+
"label",
|
|
3731
|
+
"type",
|
|
3732
|
+
"required",
|
|
3733
|
+
"options",
|
|
3734
|
+
"placeholder"
|
|
3735
|
+
],
|
|
3736
|
+
"additionalProperties": false
|
|
3737
|
+
},
|
|
3738
|
+
"description": "Buchungsfragen; Antworten gehen unter `answers[key]` in die Buchung."
|
|
3739
|
+
}
|
|
3740
|
+
},
|
|
3741
|
+
"required": [
|
|
3742
|
+
"key",
|
|
3743
|
+
"label",
|
|
3744
|
+
"title",
|
|
3745
|
+
"description",
|
|
3746
|
+
"durationMinutes",
|
|
3747
|
+
"timezone",
|
|
3748
|
+
"locations",
|
|
3749
|
+
"questions"
|
|
3750
|
+
],
|
|
3751
|
+
"additionalProperties": false
|
|
3752
|
+
}
|
|
3753
|
+
},
|
|
3754
|
+
"required": [
|
|
3755
|
+
"data"
|
|
3756
|
+
],
|
|
3757
|
+
"additionalProperties": false
|
|
3758
|
+
},
|
|
3759
|
+
"BookingSlots": {
|
|
3760
|
+
"type": "object",
|
|
3761
|
+
"properties": {
|
|
3762
|
+
"data": {
|
|
3763
|
+
"type": "object",
|
|
3764
|
+
"properties": {
|
|
3765
|
+
"timezone": {
|
|
3766
|
+
"type": "string",
|
|
3767
|
+
"description": "IANA-Zeitzone des Kalenders (zum Anzeigen umrechnen)."
|
|
3768
|
+
},
|
|
3769
|
+
"from": {
|
|
3770
|
+
"type": "string",
|
|
3771
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3772
|
+
},
|
|
3773
|
+
"to": {
|
|
3774
|
+
"type": "string",
|
|
3775
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3776
|
+
},
|
|
3777
|
+
"slots": {
|
|
3778
|
+
"type": "array",
|
|
3779
|
+
"items": {
|
|
3780
|
+
"type": "object",
|
|
3781
|
+
"properties": {
|
|
3782
|
+
"start": {
|
|
3783
|
+
"type": "string",
|
|
3784
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3785
|
+
},
|
|
3786
|
+
"end": {
|
|
3787
|
+
"type": "string",
|
|
3788
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3789
|
+
}
|
|
3790
|
+
},
|
|
3791
|
+
"required": [
|
|
3792
|
+
"start",
|
|
3793
|
+
"end"
|
|
3794
|
+
],
|
|
3795
|
+
"additionalProperties": false
|
|
3796
|
+
}
|
|
3797
|
+
}
|
|
3798
|
+
},
|
|
3799
|
+
"required": [
|
|
3800
|
+
"timezone",
|
|
3801
|
+
"from",
|
|
3802
|
+
"to",
|
|
3803
|
+
"slots"
|
|
3804
|
+
],
|
|
3805
|
+
"additionalProperties": false
|
|
3806
|
+
}
|
|
3807
|
+
},
|
|
3808
|
+
"required": [
|
|
3809
|
+
"data"
|
|
3810
|
+
],
|
|
3811
|
+
"additionalProperties": false
|
|
3812
|
+
},
|
|
3813
|
+
"BookingCreated": {
|
|
3814
|
+
"type": "object",
|
|
3815
|
+
"properties": {
|
|
3816
|
+
"data": {
|
|
3817
|
+
"type": "object",
|
|
3818
|
+
"properties": {
|
|
3819
|
+
"booked": {
|
|
3820
|
+
"type": "boolean",
|
|
3821
|
+
"const": true
|
|
3822
|
+
},
|
|
3823
|
+
"start": {
|
|
3824
|
+
"type": "string",
|
|
3825
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3826
|
+
},
|
|
3827
|
+
"end": {
|
|
3828
|
+
"type": "string",
|
|
3829
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3830
|
+
},
|
|
3831
|
+
"timezone": {
|
|
3832
|
+
"description": "Zeitzone des Buchenden, wie gesendet.",
|
|
3833
|
+
"type": "string"
|
|
3834
|
+
},
|
|
3835
|
+
"dryRun": {
|
|
3836
|
+
"description": "Vorschau: geprüft, nichts gebucht.",
|
|
3837
|
+
"type": "boolean",
|
|
3838
|
+
"const": true
|
|
3839
|
+
},
|
|
3840
|
+
"duplicate": {
|
|
3841
|
+
"description": "Dieselbe `submissionId` schon gebucht.",
|
|
3842
|
+
"type": "boolean",
|
|
3843
|
+
"const": true
|
|
3844
|
+
}
|
|
3845
|
+
},
|
|
3846
|
+
"required": [
|
|
3847
|
+
"booked"
|
|
3848
|
+
],
|
|
3849
|
+
"additionalProperties": false
|
|
3850
|
+
}
|
|
3851
|
+
},
|
|
3852
|
+
"required": [
|
|
3853
|
+
"data"
|
|
3854
|
+
],
|
|
3855
|
+
"additionalProperties": false,
|
|
3856
|
+
"description": "Gebucht. Keine internen IDs; Absagen und Verschieben über den Link in der Bestätigung."
|
|
3857
|
+
},
|
|
3858
|
+
"Appointment": {
|
|
3859
|
+
"type": "object",
|
|
3860
|
+
"properties": {
|
|
3861
|
+
"data": {
|
|
3862
|
+
"type": "object",
|
|
3863
|
+
"properties": {
|
|
3864
|
+
"bookingKey": {
|
|
3865
|
+
"type": "string"
|
|
3866
|
+
},
|
|
3867
|
+
"label": {
|
|
3868
|
+
"type": "string"
|
|
3869
|
+
},
|
|
3870
|
+
"start": {
|
|
3871
|
+
"type": "string",
|
|
3872
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3873
|
+
},
|
|
3874
|
+
"end": {
|
|
3875
|
+
"type": "string",
|
|
3876
|
+
"description": "ISO-Zeitpunkt in UTC (`…Z`)."
|
|
3877
|
+
},
|
|
3878
|
+
"status": {
|
|
3879
|
+
"type": "string",
|
|
3880
|
+
"enum": [
|
|
3881
|
+
"booked",
|
|
3882
|
+
"past",
|
|
3883
|
+
"cancelled"
|
|
3884
|
+
]
|
|
3885
|
+
},
|
|
3886
|
+
"canChange": {
|
|
3887
|
+
"type": "boolean"
|
|
3888
|
+
},
|
|
3889
|
+
"token": {
|
|
3890
|
+
"description": "Nur nach dem Verschieben: neuer Token (der alte gilt nicht mehr).",
|
|
3891
|
+
"type": "string"
|
|
3892
|
+
},
|
|
3893
|
+
"dryRun": {
|
|
3894
|
+
"type": "boolean",
|
|
3895
|
+
"const": true
|
|
3896
|
+
}
|
|
3897
|
+
},
|
|
3898
|
+
"required": [
|
|
3899
|
+
"bookingKey",
|
|
3900
|
+
"label",
|
|
3901
|
+
"start",
|
|
3902
|
+
"end",
|
|
3903
|
+
"status",
|
|
3904
|
+
"canChange"
|
|
3905
|
+
],
|
|
3906
|
+
"additionalProperties": false
|
|
3907
|
+
}
|
|
3908
|
+
},
|
|
3909
|
+
"required": [
|
|
3910
|
+
"data"
|
|
3911
|
+
],
|
|
3912
|
+
"additionalProperties": false
|
|
3913
|
+
}
|
|
3914
|
+
}
|
|
3915
|
+
}
|
|
3916
|
+
}
|