MeetAgain API

Alle CMS-Seiten mit zugehöriger Gruppe und Blockanzahl je Sprache auflisten

Antworten

Beispiel-Anfrage

curl '/api/v1/cms/pages' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Katalog der Blocktypen und der Felder, die jeder akzeptiert

Antworten

Beispiel-Anfrage

curl '/api/v1/cms/block-types' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einen Block löschen

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/cms/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Felder über einen gespeicherten Block legen

Die Nutzdaten werden über die gespeicherten gelegt, sodass ein Teilkörper nur die genannten Felder ändert.

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PATCH '/api/v1/cms/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"Text","payload":"value"}'

Blöcke einer Seite in einer Sprache, in Reihenfolge

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/cms/pages/1/blocks?locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einen Block an eine Seite in einer Sprache anhängen

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/cms/pages/1/blocks' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locale":"en","type":"Text","payload":"value"}'

Einen Block innerhalb seiner Seite und Sprache eine Position nach oben oder unten verschieben

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/cms/blocks/1/move' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"direction":"value"}'

Alt-Text für ein Bild speichern, nach Sprache abgelegt

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PUT '/api/v1/images/1/alt' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"alt":"value"}'

Bilder ohne Alt-Text je Sprache auflisten (Keyset)

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/images/missing-alt?after_id=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Verkleinerte Vorschau des Originalbilds ausliefern

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/images/1/content' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Aktuelle Sicherheitsvorfälle auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/security/incidents?limit=1&since=value' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Sicherheitsvorfall mit Anbieterberichten abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/security/incidents/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

SEO-Zustand mit Veränderungen seit dem letzten Abruf

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/seo/status?property=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Erkannte SEO-Probleme auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/seo/issues?property=1&filter=value' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Zuletzt protokollierte SEO-Maßnahmen auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/seo/actions?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

SEO-Maßnahme für die spätere Zuordnung protokollieren

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/seo/actions' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"value","title":"value","detail":"value","git_sha":"value","issue_id":"value","occurred_at":"value"}'

Aktuelle Einträge aus dem Cron-Protokoll auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/logs/cron?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einträge des E-Mail-Versandprotokolls auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/logs/sendlog?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einen einzelnen Cron-Protokolleintrag abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/logs/cron/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einen einzelnen Eintrag des Versandprotokolls abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/logs/sendlog/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Anmelden und einen persönlichen Zugriffstoken erhalten

Stellt einen neuen persönlichen Zugriffstoken für dieses Gerät aus und widerruft den Token, den eine frühere Anmeldung für denselben Gerätenamen ausgestellt hat. Sende ihn bei jedem Aufruf als Bearer-Token und melde dich bei einem 401 erneut an.

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/auth/login' \
  -H "Content-Type: application/json" \
  -d '{"email":"value","password":"value","deviceName":"value"}'

Abmelden und den aufrufenden Token widerrufen

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/auth/logout' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Von der aufrufenden Person blockierte Mitglieder auflisten

Antworten

Beispiel-Anfrage

curl '/api/v1/community/blocks' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Mitglieder der Plattform auflisten

Mitglieder, die das aufrufende Mitglied sehen darf, ohne blockierte. Wer sich aus dem Verzeichnis abgemeldet hat, fehlt auch hier - genau wie auf der Website; das Profil bleibt über die ID erreichbar.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/members?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Mitglied blockieren

Beim Blockieren werden bestehende Folgebeziehungen in beide Richtungen aufgelöst und die Unterhaltung aus beiden Postfächern ausgeblendet. Der Aufruf kann gefahrlos wiederholt werden.

Parameter

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Blockierung eines Mitglieds aufheben

Der Aufruf kann gefahrlos wiederholt werden. Das Aufheben der Blockierung stellt eine zuvor entfernte Folgebeziehung nicht wieder her.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/community/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Mitgliedsprofil lesen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/members/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Unterhaltungen des aufrufenden Mitglieds auflisten

Ein Eintrag je Person, neueste zuerst. In einer der beiden Richtungen blockierte Personen fehlen.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/conversations?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Eine Nachricht innerhalb des Bearbeitungsfensters ändern

Eine Nachricht kann zehn Minuten nach dem Senden bearbeitet werden. Die Website antwortet hier mit 403, diese Schnittstelle mit 409, weil das Zeitfenster ein Zustandskonflikt und kein Berechtigungsfehler ist.

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PATCH '/api/v1/community/messages/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Einem Mitglied folgen

Der Aufruf kann gefahrlos wiederholt werden: Er beschreibt den gewünschten Endzustand und schaltet nicht um.

Parameter

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/members/1/follow' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einem Mitglied nicht mehr folgen

Der Aufruf kann gefahrlos wiederholt werden.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/community/members/1/follow' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Mitglieder einer Gruppe auflisten

Dieselbe Liste, auf eine Gruppe eingegrenzt. Eine für die aufrufende Person nicht erreichbare Gruppe antwortet mit demselben 404 wie ein unbekannter Slug; für eine private oder verborgene Gruppe muss das Token zusätzlich me:read tragen, weil die Mitgliedschaft über diesen Scope aufgelöst wird.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/groups/slug/members?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Eine Unterhaltung lesen

Älteste zuerst. Dieser Lesezugriff verändert nichts: Er markiert die Unterhaltung nicht als gelesen, anders als das Öffnen der Seite auf der Website. Dafür ist POST /api/v1/community/conversations/{userId}/read vorgesehen.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/conversations/1?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Eine Direktnachricht senden

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/conversations/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Eine Unterhaltung als gelesen markieren

Parameter

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/conversations/1/read' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Die Town-Hall-Themen einer Gruppe auflisten

Der ganze Forenbaum der Gruppe, Tiefe zuerst, so wie die Website ihn lädt. Nicht geblättert. Eine Gruppe ohne Town Hall oder eine, deren Town Hall für die aufrufende Person geschlossen ist, antwortet mit 404 - dieselbe Antwort wie bei einem unbekannten Slug.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/groups/slug/town-hall/topics' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Thema oder Unterthema beginnen

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/groups/slug/town-hall/topics' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"value","parentId":"value"}'

Die Town-Hall-Galerie einer Gruppe auflisten

Die zu den Veranstaltungen der Gruppe hochgeladenen Fotos, neueste zuerst, jeweils mit ihrer Veranstaltung. Von Mitgliedern gemeldete Fotos fehlen, wie auf der Veranstaltungsseite.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/groups/slug/town-hall/gallery?limit=1&offset=1&locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Thema löschen

Der Autor darf ein Thema löschen, solange es keine Unterthemen und keine Antworten hat; ein Admin löscht es mit seinem ganzen Teilbaum.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/community/groups/slug/town-hall/topics/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Thema umbenennen (Autor oder Admin)

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PATCH '/api/v1/community/groups/slug/town-hall/topics/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"value"}'

Die Antworten auf ein Thema auflisten

Neueste zuerst, rückwärts geblättert wie Veranstaltungskommentare: nextBefore der vorigen Seite übergeben.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/community/groups/slug/town-hall/topics/1/replies?before=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Auf ein Thema antworten

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/community/groups/slug/town-hall/topics/1/replies' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Eine Antwort löschen (eigene oder als Admin)

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/community/groups/slug/town-hall/topics/1/replies/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Zusage und Gäste für ein Event setzen

Idempotent: setzt Zusage und Gästezahl in einem Aufruf und antwortet mit dem sich ergebenden Stand.

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PUT '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"going":"value","guests":"value"}'

Für ein Event zusagen

Parameter

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Zusage für ein Event zurückziehen

Das Zurückziehen wird nie abgelehnt: eine abgesagte Veranstaltung, eine bereits begonnene und eine verlorene Gruppenmitgliedschaft lassen das Mitglied alle von der Teilnehmerliste.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Die Fotos einer Veranstaltung auflisten

Die Fotos der Veranstaltung in allen erzeugten Größen. Von Mitgliedern gemeldete Fotos fehlen, wie auf der Veranstaltungsseite.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events/1/images' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Bild zu einem Event hochladen

Parameter

Request Body

Content-Type: multipart/form-data

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/events/1/images' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@/path/to/file"

Die Kommentare zu einer Veranstaltung auflisten

Neueste zuerst, wie auf der Veranstaltungsseite. Für die nächste Seite den Wert nextBefore der vorherigen Seite übergeben.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events/1/comments?before=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Kommentar zu einem Event schreiben

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/events/1/comments' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Auflisten, wer zu einer Veranstaltung kommt

Wer kommt, so wie die Veranstaltungsseite es angemeldeten Mitgliedern zeigt: die Personen mit Zusage und ihren Gästen, dazu die von der Organisation gepflegte externe Zahl.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events/1/attendees' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Die weiteren Termine eines wiederkehrenden Treffens auflisten

Die kommenden sichtbaren Events derselben Serie, jeweils mit dem eigenen Zusagestand. Ein Event ohne Serie antwortet mit sich selbst.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events/1/occurrences' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Event-Bild löschen (eigener Upload oder als Admin)

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/events/1/images/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Event-Kommentar löschen (eigener oder als Admin)

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/events/1/comments/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Öffentliche kommende Events auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events?locale=en&from=value&to=value&limit=1&offset=1&group=weiqi-club'

Ein einzelnes Event über die ID abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/events/1?locale=value'

Mitglieder einer Gruppe auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/groups/groupSlug/admin/members' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einstellungen einer Gruppe lesen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/groups/weiqi-club/admin/settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Aktive Gruppen auflisten

Antworten

Beispiel-Anfrage

curl '/api/v1/groups'

Eine Gruppe über den Slug abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/groups/groupSlug'

CMS-Seiten einer Gruppe auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/groups/weiqi-club/cms?language=en'

Metadaten einer CMS-Seite über Gruppe und Slug abrufen

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/groups/platform/cms/about?language=value'

Profil des angemeldeten Benutzers abrufen

Antworten

Beispiel-Anfrage

curl '/api/v1/me' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Das Profil des angemeldeten Mitglieds bearbeiten

Es ändern sich nur die Felder, die im Body stehen. Für den Namen gilt die Regel der Website: ein bereits gespeicherter Name über der Grenze bleibt gültig, eine Änderung muss hineinpassen.

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PATCH '/api/v1/me' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"value","bio":"value","locale":"value","public":"value"}'

Kommende Zusagen des angemeldeten Benutzers auflisten

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/me/rsvps?locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Das Profilbild des angemeldeten Mitglieds ersetzen

Ersetzt das Profilbild des Mitglieds. Das bisherige Bild bleibt wie auf der Website in der eigenen Galerie.

Request Body

Content-Type: multipart/form-data

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/me/avatar' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@/path/to/file"

Die Gruppen des angemeldeten Mitglieds auflisten

Jede Gruppe, in der das Mitglied ist oder um Aufnahme gebeten hat, auch die, die es gesperrt haben, jeweils mit Rolle und Status der Mitgliedschaft.

Antworten

Beispiel-Anfrage

curl '/api/v1/me/groups' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Die kommenden Treffen des angemeldeten Mitglieds auflisten

Die kommenden Events der Gruppen des Mitglieds plus die sichtbaren kommenden Events, für die es anderswo zugesagt hat; abgesagte eingeschlossen und gekennzeichnet.

Parameter

Antworten

Beispiel-Anfrage

curl '/api/v1/me/events?from=value&limit=1&offset=1&locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Das Benachrichtigungssignal-Token für dieses Gerät ausstellen

Stellt für das aufrufende App-Gerät ein zweites Token aus, das nur GET /api/v1/signal lesen darf und 90 Tage gültig ist. Eine erneute Anfrage ersetzt es, und der Widerruf des App-Tokens des Geräts widerruft es ebenfalls.

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/me/signal-token' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Benachrichtigungen des angemeldeten Mitglieds auflisten

Die Benachrichtigungsglocke der Website, als Daten. Jeder Eintrag wird live aus denselben Providern berechnet, die auch die Website nutzt; nichts wird gespeichert, es gibt also keinen Gelesen-Status, keine Historie und keinen Cursor. Die Beschriftungen kommen in der angefragten Sprache zurück.

Antworten

Beispiel-Anfrage

curl '/api/v1/me/notifications' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Registrierte Push-Geräte auflisten

Enthält außerdem den öffentlichen VAPID-Schlüssel, den ein Client zum Abonnieren braucht, und ob Push auf dieser Plattform überhaupt konfiguriert ist.

Antworten

Beispiel-Anfrage

curl '/api/v1/me/push-subscriptions' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ein Push-Gerät registrieren

Registriert einen Web-Push-Endpunkt für das aufrufende Token, sodass ein Widerruf des Geräts unter /profile/access-tokens auch seine Pings beendet. Ein erneutes Senden eines bekannten Endpunkts verschiebt ihn auf das aufrufende Gerät und antwortet mit 200.

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/me/push-subscriptions' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"value","p256dh":"value","auth":"value","transport":"value"}'

Benachrichtigungseinstellungen des angemeldeten Mitglieds lesen

Derselbe Hauptschalter und dieselben sechs Schalter, die das Mitglied unter /profile/config bearbeitet.

Antworten

Beispiel-Anfrage

curl '/api/v1/me/notification-settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Benachrichtigungseinstellungen des angemeldeten Mitglieds bearbeiten

Nur die im Body enthaltenen Schlüssel ändern sich. Der Schreibvorgang läuft über denselben Dienst wie auf der Website, eine Änderung hier erscheint also unter /profile/config.

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X PATCH '/api/v1/me/notification-settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Ein Push-Gerät entfernen

Entfernt ein registriertes Gerät. Der Datensatz eines anderen Mitglieds antwortet mit 404 statt 403, damit der Endpunkt nicht bestätigt, dass eine ID existiert.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/me/push-subscriptions/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Die offenen Gruppeneinladungen auflisten

Einladungen an das aufrufende Mitglied, ohne die, die eine Sperre in einer der beiden Richtungen verbirgt.

Antworten

Beispiel-Anfrage

curl '/api/v1/memberships/invitations' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Einer gelisteten Gruppe beitreten oder darum bitten

Hier lässt sich nur eine Gruppe betreten, die im Gruppenverzeichnis steht. Einer versteckten Gruppe tritt man auf ihrer eigenen Domain bei, einer privaten nur per Einladung, daher antworten beide mit group_not_joinable. Verlangt die Gruppe eine Freigabe, kommt die Mitgliedschaft als pending zurück.

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/memberships/groups/slug' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platformMailConsent":"value"}'

Eine Gruppe verlassen

Es gelten die Regeln der Website: die letzte Person mit Eigentümerrolle kann nicht gehen, ein gesperrtes Mitglied auch nicht, und die Plattformgruppe lässt sich erst verlassen, wenn sie für keine weitere Mitgliedschaft mehr gebraucht wird.

Parameter

Antworten

Beispiel-Anfrage

curl -X DELETE '/api/v1/memberships/groups/slug' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Eine Gruppeneinladung annehmen

Beim Annehmen entsteht die Mitgliedschaft in der eingeladenen Rolle. Solange das Mitglied der Plattformgruppe noch beitreten muss, antwortet dies mit 409 platform_crossing_required; mit platformMailConsent erneut aufrufen, um diese Frage zuerst zu beantworten.

Parameter

Request Body

Content-Type: application/json

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/memberships/invitations/1/accept' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platformMailConsent":"value"}'

Eine Gruppeneinladung ablehnen

Parameter

Antworten

Beispiel-Anfrage

curl -X POST '/api/v1/memberships/invitations/1/decline' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ob sich für das Mitglied etwas geändert hat

Ein undurchsichtiger Wert, der sich ändert, wenn sich die Glocke ändert, wenn eine Veranstaltung, der das Mitglied zugesagt hat, abgesagt, zeitlich verschoben oder an einen anderen Ort verlegt wird, und wenn ihre Erinnerung fällig wird. Er verrät nichts weiter, daher kann ein Token, das nur diesen Bereich lesen darf, dort liegen, wo die App es nicht schützen kann.

Antworten

Beispiel-Anfrage

curl '/api/v1/signal' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Endpunkt für die Statusprüfung

Antworten

Beispiel-Anfrage

curl '/api/status'