Vai al contenuto
AchaduDevelopers
API operativaVai al sito web
Cruscotto
Developers/API/group_activity
Gruppi

Controlla l'attività del gruppo

Riepilogare entrate, uscite e pubblicazioni senza rivelare i partecipanti.

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

La lettura rispetta i filtri e restituisce solo le risorse visibili all'account collegato alla chiave.

EFFETTO

Non modifica le risorse né attiva la pubblicazione.

RIPETIZIONE

L'operazione è sicura da ripetere. Su 429 o 5xx, utilizzare il backoff esponenziale con jitter.

Richiesta

idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatorio
daysinteger · queryFinestra di analisi in giorni.min 1 · max 365 · default 30facoltativo
AuthorizationBearer ach_live_...
Acceptapplication/json
Ambitogroups:read

Esempio eseguibile

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

Risposta ed errori

Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.

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..."
}
200Operazione completata.
400Parametro, corpo o transizione non validi.
401Chiave mancante, non valida, scaduta o revocata.
402Il piano dell'account non rilascia questa interfaccia.
403A chave precisa do escopo groups:read.
404La funzionalità non esiste in questo account.
409Lo stato attuale impedisce questa operazione.
413Il corpo JSON supera i 128 KB.
429La finestra di 120 richieste al minuto è stata superata.