Für Entwickler

API-Dokumentation

mamiio stellt die kommenden öffentlichen Events als offene Schnittstelle bereit — ohne Anmeldung, ohne API-Key, nur lesend. Wer sie benutzen will, kann direkt loslegen.

Basis-Adresse

Alle Endpunkte liegen unter https://api.mamiio.com. Es gibt keine Versionierung im Pfad; falls sich je etwas Grundlegendes ändert, steht es zuerst hier und in der OpenAPI-Beschreibung.

Events auflisten

GET /e liefert die kommenden Events, aufsteigend nach dem nächsten anstehenden Termin.

curl "https://api.mamiio.com/e?city=Berlin&limit=20"

Optionale Query-Parameter:

  • city — exakter Stadtname, z. B. Berlin. Kein Teilstring-Match.
  • stage — Name einer Lebensphase, z. B. Schwangerschaft.
  • category — Kategorie-Slug, wie er in der Antwort unter categories[].slug steht.
  • limit — Einträge pro Seite, Standard 100, Maximum 200. Größere Werte werden still gekappt.
  • offset — übersprungene Einträge fürs Blättern.

Die Antwort ist ein Objekt mit events, total und has_more. Achtung: total ist die Anzahl der Einträge in dieser Antwort, nicht die Gesamtzahl aller Events — zum Blättern also has_more auswerten und offset um die tatsächlich erhaltene Anzahl erhöhen.

Ein einzelnes Event holen

GET /e/<uuid> liefert die Einzelansicht mit Beschreibung, Tags, Altersspanne und Veranstalter-Details.

Die Event-URLs dieser Website benutzen statt der UUID einen 22 Zeichen langen base64url-Token am Ende des Slugs (/events/babymassage-<token>). Der Endpunkt erwartet die UUID-Form; alle UUIDs stehen in der Listen-Antwort.

Erreichbarkeit

GET /health antwortet mit {"status":"ok"}, sobald das Backend erreichbar ist.

Was die API nicht liefert

  • Keine exakten Adressen — nur Ortsname, Stadtteil und Stadt. Das ist Absicht, nicht Vergesslichkeit.
  • Keine privaten Events, keine Gruppen-Events, keine Teilnehmerdaten und keine Kommentare (nur deren Anzahl).
  • Keine Schreiboperationen. Events anlegen geht in der App oder im Partner-Bereich.

Bild-URLs laufen ab

image_url und partner_logo_url sind signierte URLs mit einer Stunde Gültigkeit. Sie eignen sich zum sofortigen Anzeigen — nicht zum Zwischenspeichern und nicht für eigene Metadaten oder Feeds, denn danach sind sie tot. Wer ein stabiles Bild braucht, nimmt das Vorschaubild der Event-Seite: https://mamiio.com/events/<slug>/opengraph-image.

Faire Nutzung

Es gibt kein hartes Rate-Limit, aber auch keinen Grund für Dauerfeuer: die Liste ändert sich täglich, nicht sekündlich. Ein paar Abrufe am Tag reichen. Wer etwas Größeres damit vorhat, schreibt am besten kurz an hallo@mamiio.com — dann wissen wir Bescheid, bevor es auffällt.

Maschinenlesbar

  • OpenAPI 3.1 — vollständige Beschreibung aller Felder.
  • API-Katalog— der Einstiegspunkt nach RFC 9727.
  • llms.txt — Kurzüberblick über die Website für Agenten.

Die Seiten /, /events und die Event-Detailseiten gibt es außerdem als Markdown: einfach mit dem Header Accept: text/markdown anfragen.

curl -H "Accept: text/markdown" "https://mamiio.com/events"