Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Developers/API/group_activity
Groups

Consultar atividade do grupo

Resume entradas, saídas e publicações sem revelar participantes.

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

A leitura respeita os filtros e devolve somente recursos visíveis para a conta vinculada à chave.

EFEITO

Não altera recursos nem dispara publicação.

REPETIÇÃO

A operação é segura para repetição. Em 429 ou 5xx, use backoff exponencial com jitter.

Solicitação

idstring · pathIdentificador do recurso.minLength 2 · maxLength 100obrigatório
daysinteger · queryJanela de análise em dias.min 1 · max 365 · default 30opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopogroups:read

Exemplo executável

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

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

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..."
}
200Operação concluída.
400Parâmetro, corpo ou transição inválida.
401Chave ausente, inválida, expirada ou revogada.
402O plano da conta não libera esta interface.
403A chave precisa do escopo groups:read.
404Recurso inexistente nesta conta.
409O estado atual impede esta operação.
413O corpo JSON ultrapassa 128 KB.
429A janela de 120 solicitações por minuto foi excedida.