Zum Inhalt springen
AchaduDevelopers
Developers/API/group_activity
Gruppen

Überprüfen Sie die Gruppenaktivität

Fassen Sie Ein- und Austritte sowie Veröffentlichungen zusammen, ohne die Teilnehmer preiszugeben.

GET/groups/{id}/activitygroups:read
VERHALTEN

Der Lesevorgang berücksichtigt die Filter und gibt nur Ressourcen zurück, die für das mit dem Schlüssel verknüpfte Konto sichtbar sind.

WIRKUNG

Ändert keine Ressourcen und löst keine Veröffentlichung aus.

WIEDERHOLUNG

Der Vorgang kann problemlos wiederholt werden. Verwenden Sie auf 429 oder 5xx einen exponentiellen Backoff mit Jitter.

Anfrage

idstring · pathRessourcenbezeichner.minLength 2 · maxLength 100obligatorisch
daysinteger · queryAnalysefenster in Tagen.min 1 · max 365 · default 30optional
AuthorizationBearer ach_live_...
Acceptapplication/json
Umfanggroups:read

Ausführbares Beispiel

curl
curl 'https://achadu.com/api/v1/groups/resource_id/activity' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Reaktion und Fehler

Jede Antwort enthält request_id. Listen fügen Paginierung hinzu; Veränderbare Ressourcen geben nach der Operation den persistenten Zustand zurück.

200 application/json
{
  "data": {
    "group_id": "grp_01J...",
    "group_name": "Home deals",
    "joins": 32,
    "leaves": 7,
    "net_members": 25,
    "publications": 48,
    "days": 30
  },
  "request_id": "req_01J..."
}
200Vorgang abgeschlossen.
400Ungültiger Parameter, Körper oder Übergang.
401Fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel.
402Der Account-Plan gibt diese Schnittstelle nicht frei.
403A chave precisa do escopo groups:read.
404Die Funktion ist in diesem Konto nicht vorhanden.
409Der aktuelle Status verhindert diesen Vorgang.
413Der JSON-Körper ist größer als 128 KB.
429Das Zeitfenster von 120 Anfragen pro Minute wurde überschritten.