Passer au contenu
AchaduDevelopers
API opérationnelleAller sur le site Web
Tableau de bord
Developers/API/group_activity
Groupes

Vérifier l'activité du groupe

Résumez les entrées, sorties et publications sans révéler les participants.

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

La lecture respecte les filtres et renvoie uniquement les ressources visibles par le compte lié à la clé.

EFFET

Ne modifie pas les ressources et ne déclenche pas la publication.

RÉPÉTITION

L’opération peut être répétée en toute sécurité. Sur 429 ou 5xx, utilisez l'intervalle exponentiel avec gigue.

Demande

idstring · pathIdentificateur de ressource.minLength 2 · maxLength 100obligatoire
daysinteger · queryFenêtre d'analyse en jours.min 1 · max 365 · default 30facultatif
AuthorizationBearer ach_live_...
Acceptapplication/json
Portéegroups:read

Exemple d'exécutable

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

Réponse et erreurs

Chaque réponse inclut request_id. Les listes ajoutent une pagination ; les ressources mutables renvoient l'état persistant après l'opération.

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..."
}
200Opération terminée.
400Paramètre, corps ou transition non valide.
401Clé manquante, invalide, expirée ou révoquée.
402Le plan de compte ne libère pas cette interface.
403A chave precisa do escopo groups:read.
404La fonctionnalité n'existe pas dans ce compte.
409L'état actuel empêche cette opération.
413Le corps JSON dépasse 128 Ko.
429La fenêtre de 120 requêtes par minute a été dépassée.