Für Ausflugsziele
Öffnungszeiten, Preise und Kontaktdaten ändern sich? Mit unserer kostenlosen Schnittstelle schickt euer Kassensystem, eure Website oder euer Dienstleister die Daten direkt zu uns – Familien sehen sie sofort. Lieber per Hand? Im Bereich „Meine Ausflugsziele“ geht es auch im Browser.
Authorization: Bearer <Schlüssel> mitsenden.GET /api/v1/activitiesEure Ausflugsziele mit id, Titel, Ort und Rolle.
curl https://famdaro.de/api/v1/activities \ -H "Authorization: Bearer fam_xxxxxxxx_…"
GET /api/v1/activities/<id>Alle pflegbaren Daten eines Ausflugsziels.
PATCH /api/v1/activities/<id>Ändert nur die mitgesendeten Felder und antwortet mit dem neuen Stand.
curl -X PATCH https://famdaro.de/api/v1/activities/<id> \
-H "Authorization: Bearer fam_xxxxxxxx_…" \
-H "Content-Type: application/json" \
-d '{
"openingHours": {
"weekly": [
{ "day": 1, "open": "09:00", "close": "18:00" },
{ "day": 6, "open": "10:00", "close": "16:00" }
],
"note": "Letzter Einlass 17:00 Uhr"
},
"priceTiers": [
{ "label": "Erwachsene", "price": 14.5 },
{ "label": "Kinder (3–12 Jahre)", "price": 9 },
{ "label": "Kinder unter 3", "price": 0 }
],
"pricePeriods": [
{
"id": "wochenende",
"label": "Wochenende",
"days": [6, 7],
"tiers": [{ "label": "Erwachsene", "price": 16 }]
},
{
"id": "hauptsaison",
"label": "Hauptsaison",
"season": { "from": "04-01", "to": "10-31" },
"tiers": [{ "label": "Erwachsene", "price": 18 }]
}
],
"phone": "+49 40 123456"
}'Antwort (200)
{
"id": "5b0c…",
"title": "Wildpark Beispielstadt",
"famdaroUrl": "https://famdaro.de/activities/wildpark-beispielstadt/5b0c…",
"url": "https://www.wildpark-beispielstadt.de",
"operatorUpdatedAt": "2026-09-30T10:35:16.101Z",
"openingHours": { "weekly": [ … ], "note": "Letzter Einlass 17:00 Uhr" },
"priceTiers": [ … ],
"pricePeriods": [ … ],
"priceUnknown": false,
"phone": "+49 40 123456",
…
}| Feld | Typ | Bedeutung |
|---|---|---|
openingHours | Objekt | null | weekly: Liste aus { day: 1–7 (Mo–So), open: "HH:MM", close: "HH:MM" }; mehrere Zeiträume pro Tag möglich; Tage ohne Eintrag gelten als geschlossen. seasons (optional, statt weekly, dann weekly: []): bis zu 6 Saisons aus { from: 1–12, to: 1–12 (Monate, einschließlich; 11 → 2 = November bis Februar), weekly }; Monate ohne Saison gelten als geschlossen. lastEntryMinutes: optional, letzter Einlass in Minuten vor Schließung (5–240). note: optionaler Hinweis (max. 500 Zeichen). null = keine festen Öffnungszeiten. |
priceTiers | Liste | { label, price (Euro), note? } – max. 30 Einträge. Leere Liste = Eintritt frei. |
pricePeriods | Liste | null | Abweichende Preislisten: { id, label, season?: { from: "MM-TT", to: "MM-TT" }, days?: [1–7] (ISO-Wochentage, 1 = Mo … 7 = So, ohne Doppelungen), tiers: [{ label, price, note? }], note? }. label max. 80, note max. 200 Zeichen. season oder days ist Pflicht; season gilt jedes Jahr und darf über den Jahreswechsel gehen. Max. 12 Zeiträume, je max. 30 Preise, IDs eindeutig. Die spezifischste passende Periode gewinnt (Saison + Wochentage vor Wochentagen vor Saison); eine leere tiers-Liste bedeutet an diesen Tagen Eintritt frei. null = keine Abweichungen. |
priceUnknown | Boolean | true = Preise nicht angeben („auf Anfrage“); priceTiers und pricePeriods bleiben gespeichert, werden aber ausgeblendet. |
priceNote | String | Hinweis unter den Preisen (max. 500 Zeichen), z. B. „Kinder unter 1 m frei“. "" = kein Hinweis. |
paymentMethods | Liste | null | Zahlungsarten vor Ort, jede höchstens einmal: "cash", "girocard", "visa", "mastercard", "amex", "apple_pay", "google_pay", "paypal". null oder leere Liste = keine Angabe. |
description | Liste | Beschreibung als Blöcke: { type: "paragraph", data: { text } }, { type: "header", data: { text, level: 2 | 3 } }, { type: "list", data: { style: "ordered" | "unordered", items: [Text] } } oder { type: "delimiter", data: {} }. Im Text sind <b>, <i>, <u>, <a href> und <br> erlaubt. Max. 200 Blöcke, insgesamt etwa 20.000 Zeichen. Leere Liste = keine Beschreibung. |
url | String | Eure Website (http/https) oder "". |
phone | String | Öffentliche Telefonnummer oder "". |
email | String | Öffentliche E-Mail für Anfragen von Familien oder "". |
ageMin, ageMax | Zahl | Empfohlenes Alter 0–99. |
weatherType | String | "indoor", "outdoor" oder "both". |
strollerFriendly, babyFriendly, wheelchairAccessible, accessible, dogFriendly, bikeFriendly | Boolean | Ausstattung für Familien. |
accessNotes | String | Familien-Tipp, max. 2000 Zeichen. |
gastro | Objekt | null | Gastronomie vor Ort: kind (none, kiosk, imbiss, cafe, restaurant), picnic (Boolean), priceLevel (1–3 oder null), items (bis 20 × { label, price } als ungefähre Preise in Euro), note. |
Titel, Adresse und Kategorien pflegt unser Team – schreibt uns dafür an [email protected]. Unbekannte Felder werden mit einem Fehler abgelehnt, damit Tippfehler auffallen.
401 – Schlüssel fehlt, ist ungültig oder widerrufen404 – Ausflugsziel unbekannt oder ihr seid nicht freigeschaltet415 – kein JSON gesendet422 – Daten ungültig; error nennt das Feld429 – mehr als 120 Anfragen pro MinuteJede Änderung wird mit Zeitpunkt protokolliert. Auf eurer Seite erscheint „Vom Betreiber gepflegt“ mit dem Datum der letzten Aktualisierung.