@dealsystem/site 0.0.0-stage → 0.2.0

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.
Files changed (182) hide show
  1. package/README.md +145 -2
  2. package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
  3. package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
  4. package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
  5. package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
  6. package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
  7. package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
  8. package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
  9. package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
  10. package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
  11. package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
  12. package/agent-files/claude/skills/veroeffentlichen/SKILL.md +32 -0
  13. package/agent-files/cursor/rules/dealsystem.mdc +7 -0
  14. package/agent-files/manifest.json +93 -0
  15. package/contract/README.md +41 -0
  16. package/contract/ds-content.v1.json +2355 -0
  17. package/contract/external-presets.v1.json +65 -0
  18. package/contract/funnel-code-config.md +87 -0
  19. package/contract/site-api.v1.json +3916 -0
  20. package/dist/client/altcha-workers.d.ts +10 -0
  21. package/dist/client/attribution.d.ts +119 -0
  22. package/dist/client/attribution.js +341 -0
  23. package/dist/client/bookingClient.svelte.d.ts +166 -0
  24. package/dist/client/bookingClient.svelte.js +369 -0
  25. package/dist/client/bookingTime.d.ts +46 -0
  26. package/dist/client/bookingTime.js +109 -0
  27. package/dist/client/captcha.d.ts +26 -0
  28. package/dist/client/captcha.js +71 -0
  29. package/dist/client/captchaSession.d.ts +21 -0
  30. package/dist/client/captchaSession.js +105 -0
  31. package/dist/client/collections.d.ts +34 -0
  32. package/dist/client/collections.js +40 -0
  33. package/dist/client/externalScript.d.ts +20 -0
  34. package/dist/client/externalScript.js +36 -0
  35. package/dist/client/funnelState.svelte.d.ts +47 -0
  36. package/dist/client/funnelState.svelte.js +81 -0
  37. package/dist/client/leadClient.svelte.d.ts +131 -0
  38. package/dist/client/leadClient.svelte.js +250 -0
  39. package/dist/client/pageview.d.ts +7 -0
  40. package/dist/client/pageview.js +44 -0
  41. package/dist/client/siteApi.d.ts +211 -0
  42. package/dist/client/siteApi.js +320 -0
  43. package/dist/client/tracking.d.ts +18 -0
  44. package/dist/client/tracking.js +93 -0
  45. package/dist/client/validation.d.ts +10 -0
  46. package/dist/client/validation.js +66 -0
  47. package/dist/components/Booker.svelte +729 -0
  48. package/dist/components/Booker.svelte.d.ts +42 -0
  49. package/dist/components/CollectionList.svelte +122 -0
  50. package/dist/components/CollectionList.svelte.d.ts +65 -0
  51. package/dist/components/ConsentGate.svelte +68 -0
  52. package/dist/components/ConsentGate.svelte.d.ts +44 -0
  53. package/dist/components/CookieBanner.svelte +303 -0
  54. package/dist/components/CookieBanner.svelte.d.ts +29 -0
  55. package/dist/components/Datenschutz.svelte +84 -0
  56. package/dist/components/Datenschutz.svelte.d.ts +26 -0
  57. package/dist/components/Embed.svelte +263 -0
  58. package/dist/components/Embed.svelte.d.ts +41 -0
  59. package/dist/components/ExternalScript.svelte +94 -0
  60. package/dist/components/ExternalScript.svelte.d.ts +41 -0
  61. package/dist/components/Impressum.svelte +59 -0
  62. package/dist/components/Impressum.svelte.d.ts +25 -0
  63. package/dist/components/LeadForm.svelte +475 -0
  64. package/dist/components/LeadForm.svelte.d.ts +35 -0
  65. package/dist/components/LeadHoneypot.svelte +43 -0
  66. package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
  67. package/dist/components/Link.svelte +48 -0
  68. package/dist/components/Link.svelte.d.ts +30 -0
  69. package/dist/components/MapEmbed.svelte +154 -0
  70. package/dist/components/MapEmbed.svelte.d.ts +28 -0
  71. package/dist/components/MediaImage.svelte +218 -0
  72. package/dist/components/MediaImage.svelte.d.ts +128 -0
  73. package/dist/components/MediaVideo.svelte +103 -0
  74. package/dist/components/MediaVideo.svelte.d.ts +20 -0
  75. package/dist/components/RichText.svelte +105 -0
  76. package/dist/components/RichText.svelte.d.ts +55 -0
  77. package/dist/components/Seo.svelte +89 -0
  78. package/dist/components/Seo.svelte.d.ts +45 -0
  79. package/dist/components/SiteFooterLegal.svelte +75 -0
  80. package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
  81. package/dist/components/SiteHead.svelte +79 -0
  82. package/dist/components/SiteHead.svelte.d.ts +32 -0
  83. package/dist/components/Text.svelte +100 -0
  84. package/dist/components/Text.svelte.d.ts +55 -0
  85. package/dist/components/Tracking.svelte +30 -0
  86. package/dist/components/Tracking.svelte.d.ts +14 -0
  87. package/dist/components/Zeitfenster.svelte +92 -0
  88. package/dist/components/Zeitfenster.svelte.d.ts +34 -0
  89. package/dist/components/legal.d.ts +12 -0
  90. package/dist/components/legal.js +27 -0
  91. package/dist/config/index.d.ts +121 -0
  92. package/dist/config/index.js +602 -0
  93. package/dist/config/static/index.d.ts +3 -0
  94. package/dist/config/static/index.js +5 -0
  95. package/dist/config/static/lines.d.ts +9 -0
  96. package/dist/config/static/lines.js +22 -0
  97. package/dist/config/static/literal.d.ts +45 -0
  98. package/dist/config/static/literal.js +175 -0
  99. package/dist/config/static/siteConfig.d.ts +39 -0
  100. package/dist/config/static/siteConfig.js +150 -0
  101. package/dist/consent/consent.svelte.d.ts +91 -0
  102. package/dist/consent/consent.svelte.js +221 -0
  103. package/dist/content/index.d.ts +123 -0
  104. package/dist/content/index.js +247 -0
  105. package/dist/contentBlock.d.ts +45 -0
  106. package/dist/contentBlock.js +78 -0
  107. package/dist/csp/index.d.ts +27 -0
  108. package/dist/csp/index.js +74 -0
  109. package/dist/external/csp.d.ts +25 -0
  110. package/dist/external/csp.js +104 -0
  111. package/dist/external/hosts.d.ts +30 -0
  112. package/dist/external/hosts.js +128 -0
  113. package/dist/external/presets.d.ts +54 -0
  114. package/dist/external/presets.js +212 -0
  115. package/dist/external/resolve.d.ts +39 -0
  116. package/dist/external/resolve.js +254 -0
  117. package/dist/index.d.ts +32 -0
  118. package/dist/index.js +32 -0
  119. package/dist/internal/consentNeed.d.ts +21 -0
  120. package/dist/internal/consentNeed.js +50 -0
  121. package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
  122. package/dist/internal/dealsystem-legal-imprint.js +5 -0
  123. package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
  124. package/dist/internal/dealsystem-legal-privacy.js +5 -0
  125. package/dist/internal/dealsystem-site-data.d.ts +3 -0
  126. package/dist/internal/dealsystem-site-data.js +2 -0
  127. package/dist/internal/imprint.d.ts +4 -0
  128. package/dist/internal/imprint.js +10 -0
  129. package/dist/internal/mediaImage.d.ts +15 -0
  130. package/dist/internal/mediaImage.js +22 -0
  131. package/dist/internal/privacy.d.ts +4 -0
  132. package/dist/internal/privacy.js +10 -0
  133. package/dist/internal/providers.d.ts +9 -0
  134. package/dist/internal/providers.js +44 -0
  135. package/dist/internal/reload.d.ts +2 -0
  136. package/dist/internal/reload.js +5 -0
  137. package/dist/internal/seo.d.ts +41 -0
  138. package/dist/internal/seo.js +79 -0
  139. package/dist/internal/siteData.d.ts +7 -0
  140. package/dist/internal/siteData.js +39 -0
  141. package/dist/internal/usage.d.ts +7 -0
  142. package/dist/internal/usage.js +13 -0
  143. package/dist/keys.d.ts +20 -0
  144. package/dist/keys.js +58 -0
  145. package/dist/leadmagnet.d.ts +16 -0
  146. package/dist/leadmagnet.js +28 -0
  147. package/dist/paths.d.ts +8 -0
  148. package/dist/paths.js +9 -0
  149. package/dist/richtext/escape.d.ts +4 -0
  150. package/dist/richtext/escape.js +18 -0
  151. package/dist/richtext/server.d.ts +16 -0
  152. package/dist/richtext/server.js +123 -0
  153. package/dist/schedule.d.ts +23 -0
  154. package/dist/schedule.js +67 -0
  155. package/dist/slots.d.ts +9 -0
  156. package/dist/slots.js +38 -0
  157. package/dist/snapshot.d.ts +14 -0
  158. package/dist/snapshot.js +214 -0
  159. package/dist/types.d.ts +550 -0
  160. package/dist/types.js +4 -0
  161. package/dist/version.d.ts +2 -0
  162. package/dist/version.js +2 -0
  163. package/dist/vite/index.d.ts +85 -0
  164. package/dist/vite/index.js +641 -0
  165. package/dist/vite/scan.d.ts +47 -0
  166. package/dist/vite/scan.js +355 -0
  167. package/dist/vite/zeitfenster.d.ts +18 -0
  168. package/dist/vite/zeitfenster.js +76 -0
  169. package/docs/ablauf.md +167 -0
  170. package/docs/agents-block.md +100 -0
  171. package/docs/befehle.md +103 -0
  172. package/docs/extern.md +143 -0
  173. package/docs/gestaltung.md +139 -0
  174. package/docs/inhalte.md +224 -0
  175. package/docs/komponenten.md +1273 -0
  176. package/docs/konfiguration.md +310 -0
  177. package/docs/llms.txt +19 -0
  178. package/docs/rechtstexte.md +84 -0
  179. package/docs/regeln.md +108 -0
  180. package/docs/seo.md +55 -0
  181. package/docs/termine.md +73 -0
  182. 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
+ }