Grupos
Listar grupos
Enumera grupos sin exponer JID, sesiones o credenciales.
GET
/groupsgroups:readCOMPORTAMIENTO
La lectura respeta los filtros y devuelve solo los recursos visibles para la cuenta vinculada a la clave.
EFECTO
No cambia los recursos ni activa la publicación.
REPETICIÓN
Es seguro repetir la operación. En 429 o 5xx, use retroceso exponencial con fluctuación.
Solicitar
limitinteger · queryCantidad por página.min 1 · max 100 · default 30opcionaloffsetinteger · queryDesplazamiento de paginación.min 0 · default 0opcionalAuthorization
Bearer ach_live_...Accept
application/jsonAlcance
groups:readEjemplo ejecutable
curl
curl 'https://achadu.com/api/v1/groups' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json'Respuesta y errores
Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.
200 application/json
{
"data": [
{
"id": "grp_01J...",
"name": "Home deals",
"members": 842,
"active": 1,
"capacity": 1024,
"segment_id": "seg_01J..."
}
],
"pagination": {
"total": 1,
"limit": 30,
"offset": 0,
"has_more": false
},
"request_id": "req_01J..."
}200Operación completada.400Parámetro, cuerpo o transición no válidos.401Clave faltante, inválida, caducada o revocada.402El plan de cuenta no libera esta interfaz.403A chave precisa do escopo groups:read.404La característica no existe en esta cuenta.409El estado actual impide esta operación.413El cuerpo JSON supera los 128 KB.429Se ha superado la ventana de 120 solicitudes por minuto.