Zum Inhalt

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

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

200 OK

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."
        }
      }
    ]
  }
}
404 Nicht gefunden

Kein veröffentlichtes Programm für diese Anlage und dieses Datum (und kein späteres Programm).

422 Validierungsfehler

Ungültiger lang- oder date-Query-Wert.

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

200 OK

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."
        }
      }
    ]
  }
}
404 Nicht gefunden

Programm existiert nicht, ist nicht veröffentlicht oder gehört zu einer anderen Anlage.

422 Validierungsfehler

Ungültiger lang-Query-Wert.

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

200 OK

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"
    }
  }
]
404 Nicht gefunden

Anlage existiert nicht oder ist nicht öffentlich.

422 Validierungsfehler

Ungültiger lang-Query-Wert.

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

200 OK

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"
    }
  }
]
404 Nicht gefunden

Anlage existiert nicht oder ist nicht öffentlich.

422 Validierungsfehler

Ungültiger lang-Query-Wert.

GET /properties

Alle Anlagen mit show_on_website. Für Integration und öffentliche Karten.

Beispielanfragen

Öffentliche Anlagen auflisten

GET /properties

Antworten

200 OK

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}

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

200 OK

Ö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"
}
404 Nicht gefunden

Anlage existiert nicht oder ist nicht öffentlich.

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

200 OK

Ö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"
}
404 Nicht gefunden

Anlage existiert nicht oder ist nicht öffentlich.

RecraHub verwendet funktionale Cookies für Anmeldung, Sicherheit und Spracheinstellungen.