RecraHub Public API
Vorschau. Der v1-Vertrag kann sich vor der allgemeinen Freigabe ändern. Integrationen an openapi.json ausrichten und diese Seite beobachten.
OpenAPI-Schema · https://www.recrahub.nl/api/v1
GET
/properties/{property-id}/programmes/current-or-next
GET /properties/{property-id}/programmes/current-or-next
Liefert das veröffentlichte Programm am Auswahldatum oder das nächste veröffentlichte Programm, wenn an diesem Tag keines aktiv ist.
Query-Parameter
| Parameter | Beschreibung |
|---|---|
| lang | Optional. Unterstützte Werte hängen von den Anlagensprachen ab. Übersetzbare Felder enthalten nl, en, de, fr und localized. Localized verwendet die angeforderte Sprache, wenn verfügbar, und fällt auf Niederländisch zurück. |
| date | Optional. Auswahldatum im Format YYYY-MM-DD. Standardmäßig heute in der betrieblichen Zeitzone. |
Beispielanfragen
Aktuelles oder nächstes Programm
GET /properties/{property-id}/programmes/current-or-next
Aktuelles oder nächstes Programm für ein Datum
GET /properties/{property-id}/programmes/current-or-next?date=2026-07-01
Englische lokalisierte Werte
GET /properties/{property-id}/programmes/current-or-next?lang=en
Antworten
Programmpayload mit Programmfeldern, days, highlights und more_info.
Antwort
{
"id": 48,
"name": "Week 27",
"title": {
"nl": "Recreatieprogramma",
"en": "Recreation programme",
"de": null,
"fr": null,
"localized": "Recreation programme"
},
"start_date": "2026-07-06",
"end_date": "2026-07-12",
"urls": { "api": "https://example.com/api/v1/properties/12/programmes/48" },
"theme": {
"id": 7,
"name": {
"nl": "Zomer",
"en": "Summer",
"de": null,
"fr": null,
"localized": "Summer"
},
"description": {
"nl": "Zomerse week",
"en": "Summer week",
"de": null,
"fr": null,
"localized": "Summer week"
},
"image_url": "https://example.com/storage/themes/summer.jpg",
"highlighted": true
},
"days": [
{
"day": 1,
"date": "2026-07-06",
"activities": [
{
"id": 901,
"name": {
"nl": "Kinderdisco",
"en": "Kids disco",
"de": null,
"fr": null,
"localized": "Kids disco"
},
"starts_at": "2026-07-06T10:00:00+02:00",
"category": {
"id": 3,
"name": {
"nl": "Sport",
"en": "Sport",
"de": null,
"fr": null,
"localized": "Sport"
},
"explanation": {
"nl": "Activiteiten waarbij je actief beweegt.",
"en": "Activities where you move actively.",
"de": null,
"fr": null,
"localized": "Activities where you move actively."
},
"cta": {
"nl": "Doe mee",
"en": "Join",
"de": null,
"fr": null,
"localized": "Join"
},
"image_url": "https://example.com/storage/categories/sport.png"
},
"link": {
"url": { "nl": "https://example.com/activity-info", "en": "https://example.com/en/activity-info", "de": null, "fr": null, "localized": "https://example.com/en/activity-info" },
"label": { "nl": "Meer info", "en": "More info", "de": null, "fr": null, "localized": "More info" }
},
"signup": { "enabled": true, "status": "open" }
}
]
}
],
"highlights": [
{
"type": "activity",
"id": 34,
"name": {
"nl": "Disco avond",
"en": "Disco night",
"de": null,
"fr": null,
"localized": "Disco night"
},
"header": {
"nl": "Vandaag uitgelicht",
"en": "Highlighted today",
"de": null,
"fr": null,
"localized": "Highlighted today"
},
"description": {
"nl": "Kom dansen met het animatieteam.",
"en": "Come dance with the entertainment team.",
"de": null,
"fr": null,
"localized": "Come dance with the entertainment team."
},
"image_url": "https://example.com/storage/highlights/disco.jpg",
"program_activity_id": 901
}
],
"more_info": {
"explanation_categories": [
{
"id": 3,
"name": {
"nl": "Sport",
"en": "Sport",
"de": null,
"fr": null,
"localized": "Sport"
},
"explanation": {
"nl": "Activiteiten waarbij je actief beweegt.",
"en": "Activities where you move actively.",
"de": null,
"fr": null,
"localized": "Activities where you move actively."
},
"cta": {
"nl": "Doe mee",
"en": "Join",
"de": null,
"fr": null,
"localized": "Join"
},
"image_url": "https://example.com/storage/categories/sport.png"
}
],
"explanation_footer_text": {
"nl": "Programma onder voorbehoud.",
"en": "Programme subject to change.",
"de": null,
"fr": null,
"localized": "Programme subject to change."
},
"online": {
"enabled": true,
"url": "https://example.com/demo-park",
"show_recrateam_logo": true,
"recrateam_logo_url": "https://example.com/images/logo-recrateam.svg"
},
"practical_information": [
{
"icon": "info",
"text": {
"nl": "Verzamelen bij de receptie.",
"en": "Meet at reception.",
"de": null,
"fr": null,
"localized": "Meet at reception."
}
}
]
}
}
Kein veröffentlichtes Programm für diese Anlage und dieses Datum (und kein späteres Programm).
Ungültiger lang- oder date-Query-Wert.
GET
/properties/{property-id}/programmes/{program-id}
GET /properties/{property-id}/programmes/{program-id}
Liefert ein veröffentlichtes Programm nach ID. Das Programm muss zur Anlage im Pfad gehören.
Query-Parameter
| Parameter | Beschreibung |
|---|---|
| lang | Optional. Unterstützte Werte hängen von den Anlagensprachen ab. Übersetzbare Felder enthalten nl, en, de, fr und localized. Localized verwendet die angeforderte Sprache, wenn verfügbar, und fällt auf Niederländisch zurück. |
Beispielanfragen
Programm nach ID
GET /properties/{property-id}/programmes/{program-id}
Programm nach ID mit lokalisierten Werten
GET /properties/{property-id}/programmes/{program-id}?lang=de
Antworten
Programmpayload mit Programmfeldern, days, highlights und more_info.
Antwort
{
"id": 48,
"name": "Week 27",
"title": {
"nl": "Recreatieprogramma",
"en": "Recreation programme",
"de": null,
"fr": null,
"localized": "Recreation programme"
},
"start_date": "2026-07-06",
"end_date": "2026-07-12",
"urls": { "api": "https://example.com/api/v1/properties/12/programmes/48" },
"theme": {
"id": 7,
"name": {
"nl": "Zomer",
"en": "Summer",
"de": null,
"fr": null,
"localized": "Summer"
},
"description": {
"nl": "Zomerse week",
"en": "Summer week",
"de": null,
"fr": null,
"localized": "Summer week"
},
"image_url": "https://example.com/storage/themes/summer.jpg",
"highlighted": true
},
"days": [
{
"day": 1,
"date": "2026-07-06",
"activities": [
{
"id": 901,
"name": {
"nl": "Kinderdisco",
"en": "Kids disco",
"de": null,
"fr": null,
"localized": "Kids disco"
},
"starts_at": "2026-07-06T10:00:00+02:00",
"category": {
"id": 3,
"name": {
"nl": "Sport",
"en": "Sport",
"de": null,
"fr": null,
"localized": "Sport"
},
"explanation": {
"nl": "Activiteiten waarbij je actief beweegt.",
"en": "Activities where you move actively.",
"de": null,
"fr": null,
"localized": "Activities where you move actively."
},
"cta": {
"nl": "Doe mee",
"en": "Join",
"de": null,
"fr": null,
"localized": "Join"
},
"image_url": "https://example.com/storage/categories/sport.png"
},
"link": {
"url": { "nl": "https://example.com/activity-info", "en": "https://example.com/en/activity-info", "de": null, "fr": null, "localized": "https://example.com/en/activity-info" },
"label": { "nl": "Meer info", "en": "More info", "de": null, "fr": null, "localized": "More info" }
},
"signup": { "enabled": true, "status": "open" }
}
]
}
],
"highlights": [
{
"type": "activity",
"id": 34,
"name": {
"nl": "Disco avond",
"en": "Disco night",
"de": null,
"fr": null,
"localized": "Disco night"
},
"header": {
"nl": "Vandaag uitgelicht",
"en": "Highlighted today",
"de": null,
"fr": null,
"localized": "Highlighted today"
},
"description": {
"nl": "Kom dansen met het animatieteam.",
"en": "Come dance with the entertainment team.",
"de": null,
"fr": null,
"localized": "Come dance with the entertainment team."
},
"image_url": "https://example.com/storage/highlights/disco.jpg",
"program_activity_id": 901
}
],
"more_info": {
"explanation_categories": [
{
"id": 3,
"name": {
"nl": "Sport",
"en": "Sport",
"de": null,
"fr": null,
"localized": "Sport"
},
"explanation": {
"nl": "Activiteiten waarbij je actief beweegt.",
"en": "Activities where you move actively.",
"de": null,
"fr": null,
"localized": "Activities where you move actively."
},
"cta": {
"nl": "Doe mee",
"en": "Join",
"de": null,
"fr": null,
"localized": "Join"
},
"image_url": "https://example.com/storage/categories/sport.png"
}
],
"explanation_footer_text": {
"nl": "Programma onder voorbehoud.",
"en": "Programme subject to change.",
"de": null,
"fr": null,
"localized": "Programme subject to change."
},
"online": {
"enabled": true,
"url": "https://example.com/demo-park",
"show_recrateam_logo": true,
"recrateam_logo_url": "https://example.com/images/logo-recrateam.svg"
},
"practical_information": [
{
"icon": "info",
"text": {
"nl": "Verzamelen bij de receptie.",
"en": "Meet at reception.",
"de": null,
"fr": null,
"localized": "Meet at reception."
}
}
]
}
}
Programm existiert nicht, ist nicht veröffentlicht oder gehört zu einer anderen Anlage.
Ungültiger lang-Query-Wert.
GET
/properties/{property-id}/age-tags
GET /properties/{property-id}/age-tags
Gibt Alters-Tags zurück, die tatsächlich von veröffentlichten Programmen einer öffentlichen Anlage verwendet werden.
Query-Parameter
| Parameter | Beschreibung |
|---|---|
| lang | Optional. Unterstützte Werte hängen von den Anlagensprachen ab. Übersetzbare Felder enthalten nl, en, de, fr und localized. Localized verwendet die angeforderte Sprache, wenn verfügbar, und fällt auf Niederländisch zurück. |
Beispielanfragen
Verwendete Alters-Tags
GET /properties/{property-id}/age-tags
Englische lokalisierte Werte
GET /properties/{property-id}/age-tags?lang=en
Antworten
JSON-Array von Alters-Tag-Objekten mit derselben Textstruktur wie age_tag-Werte von Programmaktivitäten.
Antwort
[
{
"id": 5,
"name": {
"nl": "Alle leeftijden",
"en": "All ages",
"de": null,
"fr": null,
"localized": "All ages"
}
}
]
Anlage existiert nicht oder ist nicht öffentlich.
Ungültiger lang-Query-Wert.
GET
/properties/{property-id}/areas
GET /properties/{property-id}/areas
Gibt Orte zurück, die tatsächlich von veröffentlichten Programmen einer öffentlichen Anlage verwendet werden.
Query-Parameter
| Parameter | Beschreibung |
|---|---|
| lang | Optional. Unterstützte Werte hängen von den Anlagensprachen ab. Übersetzbare Felder enthalten nl, en, de, fr und localized. Localized verwendet die angeforderte Sprache, wenn verfügbar, und fällt auf Niederländisch zurück. |
Beispielanfragen
Verwendete Orte
GET /properties/{property-id}/areas
Deutsche lokalisierte Werte
GET /properties/{property-id}/areas?lang=de
Antworten
JSON-Array von Ort-Objekten mit derselben Textstruktur wie area-Werte von Programmaktivitäten.
Antwort
[
{
"id": 8,
"name": {
"nl": "Sportveld",
"en": "Sports field",
"de": "Sportplatz",
"fr": null,
"localized": "Sportplatz"
}
}
]
Anlage existiert nicht oder ist nicht öffentlich.
Ungültiger lang-Query-Wert.
GET
/properties
GET /properties
Alle Anlagen mit show_on_website. Für Integration und öffentliche Karten.
Beispielanfragen
Öffentliche Anlagen auflisten
GET /properties
Antworten
JSON-Array öffentlicher Anlagenobjekte mit id, slug, name, formatierter Adresse, Koordinaten, öffentlicher URL, Logo-URL und Headerbild-URL.
Antwort
[
{
"id": 12,
"slug": "demo-park",
"name": "Demo Park",
"formatted_address": "Example Street 1, 1234 AB Amsterdam",
"coordinates": { "lat": 52.37, "lng": 4.89 },
"url": "https://example.com/demo-park",
"logo_url": "https://example.com/storage/properties/logos/demo.png",
"header_image_url": "https://example.com/storage/properties/headers/demo.jpg"
}
]
GET
/properties/{property-id}
GET /properties/{property-id}
Liefert öffentliche Anlagendetails nach ID. Diesen Endpunkt für gespeicherte Integrationen bevorzugen, da IDs sich bei einer Slug-Änderung nicht ändern.
Beispielanfragen
Anlage nach ID
GET /properties/{property-id}
Antworten
Öffentliches Anlagenobjekt mit id, slug, name, formatierter Adresse, Koordinaten, öffentlicher URL, Logo-URL und Headerbild-URL.
Antwort
{
"id": 12,
"slug": "demo-park",
"name": "Demo Park",
"formatted_address": "Example Street 1, 1234 AB Amsterdam",
"coordinates": { "lat": 52.37, "lng": 4.89 },
"url": "https://example.com/demo-park",
"logo_url": "https://example.com/storage/properties/logos/demo.png",
"header_image_url": "https://example.com/storage/properties/headers/demo.jpg"
}
Anlage existiert nicht oder ist nicht öffentlich.
GET
/properties/by-slug/{property-slug}
GET /properties/by-slug/{property-slug}
Liefert öffentliche Anlagendetails nach Slug. Für Discovery oder nutzerseitige Links verwenden; für gespeicherte Integrationen ID bevorzugen.
Beispielanfragen
Anlage nach Slug
GET /properties/by-slug/{property-slug}
Antworten
Öffentliches Anlagenobjekt mit id, slug, name, formatierter Adresse, Koordinaten, öffentlicher URL, Logo-URL und Headerbild-URL.
Antwort
{
"id": 12,
"slug": "demo-park",
"name": "Demo Park",
"formatted_address": "Example Street 1, 1234 AB Amsterdam",
"coordinates": { "lat": 52.37, "lng": 4.89 },
"url": "https://example.com/demo-park",
"logo_url": "https://example.com/storage/properties/logos/demo.png",
"header_image_url": "https://example.com/storage/properties/headers/demo.jpg"
}
Anlage existiert nicht oder ist nicht öffentlich.