{"openapi":"3.1.0","info":{"title":"Artbild-Fotografie Agenten-Terminabfrage","version":"1.0.0","description":"Prüft ein bis drei Wunschdaten unverbindlich. Die Abfrage reserviert keinen Termin und ersetzt keine persönliche Buchungsbestätigung.","termsOfService":"https://artbild-fotografie.de/fuer-agenten/#konditionen","contact":{"name":"Artbild-Fotografie","url":"https://artbild-fotografie.de/kontakt/"}},"externalDocs":{"description":"Preise, Konditionen und vollständige Nutzungshinweise","url":"https://artbild-fotografie.de/fuer-agenten/"},"servers":[{"url":"https://artbild-fotografie.de"}],"paths":{"/api/agent-availability":{"get":{"operationId":"readAgentAvailabilityDocumentation","summary":"Schnittstellenvertrag lesen","responses":{"200":{"description":"Maschinenlesbare Dokumentation und aktuelle Datumsgrenzen","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"checkAgentAvailability","summary":"Ein bis drei Wunschdaten unverbindlich prüfen","description":"Zulässig sind ausschließlich konkrete Buchungsprüfungen. Nicht erlaubt: Werbung, Akquise, Vertriebsansprache, die Aufnahme in Werbeverteiler und Angebote eigener Leistungen. Für Hochzeiten wird eine Anfrage mindestens 6 Monate vorher empfohlen; dies ist keine technische Mindestfrist. Ein optionaler Bearer-Schlüssel ermöglicht eine bestätigte Client-Kennzeichnung; ohne Schlüssel bleibt die Abfrage vollständig nutzbar und eine erkannte Bot-Kategorie ist nicht verifiziert.","security":[{"agentBearer":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["dates"],"properties":{"dates":{"type":"array","minItems":1,"maxItems":3,"uniqueItems":true,"description":"Unterschiedliche Daten im Format YYYY-MM-DD, heute bis höchstens 24 Monate im Voraus. Die Daten müssen nicht aufeinanderfolgen.","items":{"type":"string","format":"date"}}}},"examples":{"threeAlternativeDates":{"value":{"dates":["2028-02-15","2028-03-15","2028-04-15"]}}}}}},"responses":{"200":{"description":"Unverbindlicher Kalenderstand für jedes angefragte Datum","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResponse"}}}},"400":{"description":"Ungültige Anfrage oder ungültiges Datum"},"413":{"description":"Anfragekörper zu groß"},"415":{"description":"Content-Type ist nicht application/json"},"429":{"description":"Zwei erfolgreiche Abfragen im 24-Stunden-Fenster wurden bereits verwendet"},"503":{"description":"Terminprüfung vorübergehend nicht verfügbar"}}}}},"components":{"securitySchemes":{"agentBearer":{"type":"http","scheme":"bearer","bearerFormat":"Agent API key","description":"Optionaler Schlüssel zur bestätigten Client-Kennzeichnung. Der Schlüssel wird nicht gespeichert. Ohne Schlüssel bleibt die API nutzbar."}},"schemas":{"AvailabilityResult":{"type":"object","additionalProperties":false,"required":["date","available"],"properties":{"date":{"type":"string","format":"date"},"available":{"type":"boolean"}}},"AvailabilityResponse":{"type":"object","required":["results","advice","rateLimit"],"properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilityResult"}},"advice":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"rateLimit":{"type":"object","required":["limit","remaining","resetAt"],"properties":{"limit":{"type":"integer","const":2},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}}}},"x-artbild":{"endpoint":"https://artbild-fotografie.de/api/agent-availability","markdownDocumentation":"https://artbild-fotografie.de/fuer-agenten.md","pricing":"https://artbild-fotografie.de/fuer-agenten/#preise","advertisingPolicy":"https://artbild-fotografie.de/fuer-agenten/#werbeverbot","availabilityIsBinding":false,"createsReservation":false,"personalConfirmationRequired":true,"recommendedWeddingInquiryLeadTimeMonths":6,"weddingLeadTimeIsRecommendationOnly":true,"usagePolicy":{"allowed":"Konkrete Anfragen zur Buchung fotografischer Leistungen im Auftrag einer interessierten Person oder Organisation.","prohibited":"Werbung, Akquise, Vertriebsansprache, die Aufnahme in Werbeverteiler und Angebote eigener Leistungen."}}}