Für Entwickler

Öffentliche API

REST (OpenAPI 3.1), MCP-Endpunkt und llms.txt. Lesen ohne Key (30 Anfragen/Min. pro IP), mit Key 120/Min. Rate-Limit-Header: X-RateLimit-Limit, X-RateLimit-Remaining.

OpenAPI/api/openapi.json MCP/api/mcp Fotografen/api/v1/me llms.txtfür LLM-Crawler

GET /api/v1/search

Fotografen suchen (Ranking wie auf der Website, Anzeigen separat gekennzeichnet)

curl "https://beste-hochzeitsfotografen.de/api/v1/search?q=München&r=50&date=2027-09-12&style=Reportage"

GET /api/v1/vendors/{slug}/availability

Belegte Tage eines Fotografen (frei/belegt, keine Details)

curl "https://beste-hochzeitsfotografen.de/api/v1/vendors/demo-alpenlicht-hochzeitsfotografie-muenchen/availability?from=2027-09-01&to=2027-09-30"

POST /api/v1/inquiries

Anfrage im Namen eines Paares anlegen (API-Key nötig, Paar bestätigt per E-Mail)

curl -X POST "https://beste-hochzeitsfotografen.de/api/v1/inquiries" -H "Authorization: Bearer bhf_demo_local_key" -H "Content-Type: application/json" \
  -d '{"email":"paar@example.com","vendors":["demo-alpenlicht-hochzeitsfotografie-muenchen"],"date":"2027-09-12","location":"München","message":"Habt ihr Zeit?"}'

MCP (Model Context Protocol)

JSON-RPC 2.0 über HTTP POST (Streamable HTTP, ohne Sessions, Protokoll 2025-06-18/2025-03-26). Öffentliche Tools: search_photographers, check_availability. Mit Fotografen-Key zusätzlich die Tools für das eigene Profil (siehe unten).

curl -X POST https://beste-hochzeitsfotografen.de/api/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_photographers","arguments":{"place":"München","date":"2027-06-19"}}}'

// Claude Code
claude mcp add --transport http hochzeitsfotografen https://beste-hochzeitsfotografen.de/api/mcp

Für Fotografen: eigenen Assistenten anbinden

Mit einem Fotografen-Key (Fotografen-Bereich → Integrationen) arbeitet dein Assistent – z. B. ChatGPT, Claude oder n8n – in deinem Profil. Jeder Key hat eigene Berechtigungen, wirkt nur auf dein Profil und lässt sich jederzeit widerrufen. Header: Authorization: Bearer bhf_live_….

MCP-Tool	REST	Berechtigung
`list_inquiries`	`GET /api/v1/me/inquiries`	Anfragen lesen
`get_thread`	`GET /api/v1/me/threads/{id}`	Anfragen lesen
`reply_to_thread`	`POST /api/v1/me/threads/{id}/messages`	Nachrichten beantworten
`create_offer`	`POST /api/v1/me/offers`	Angebote erstellen
`get_availability`	`GET /api/v1/me/availability`	Verfügbarkeit lesen
`block_dates / unblock_dates`	`POST /api/v1/me/availability`	Tage blocken und freigeben
`get_profile`	`GET /api/v1/me`	Profil lesen
`get_stats`	`GET /api/v1/me/stats`	Profil lesen

curl https://beste-hochzeitsfotografen.de/api/v1/me/inquiries?status=SENT -H "Authorization: Bearer bhf_live_…"

curl -X POST https://beste-hochzeitsfotografen.de/api/v1/me/threads/<thread_id>/messages -H "Authorization: Bearer bhf_live_…" \
  -H "Content-Type: application/json" -d '{"message":"Danke für eure Anfrage – der 12. Juni ist noch frei!"}'

Nachrichten und Angebote werden sofort an das Paar zugestellt (inkl. E-Mail-Benachrichtigung). Telefonnummern, E-Mail-Adressen und Links werden ausgeblendet; Kontaktdaten der Paare gibt die API nie heraus.
Beträge in Cent, ausschließlich wie vom Aufrufer übergeben. Limits: 120 Aufrufe/Min. je Key, 30 Nachrichten und 20 Angebote pro Stunde.
Für Konnektoren ohne eigene Header (z. B. in claude.ai oder ChatGPT) gibt es die geheime Adresse https://beste-hochzeitsfotografen.de/api/mcp/<key> – wie ein Passwort behandeln. OAuth wird derzeit nicht angeboten.
Jede schreibende Aktion wird protokolliert und ist im Fotografen-Bereich sichtbar.

Regeln

Anfragen über die API sind erst nach Bestätigung durch das Paar (E-Mail) sichtbar für Fotografen.
Anzeigen sind im Feld ad: true gekennzeichnet und nicht Teil des organischen Rankings.
Keine personenbezogenen Daten der Fotografen über die API außer öffentlich gelisteten.

API-Keys: im Admin (lokal: bhf_demo_local_key).