Grupy
Lista grup
Wyświetla listę grup bez ujawniania identyfikatorów JID, sesji i poświadczeń.
GET
/groupsgroups:readZACHOWANIE
Odczyt uwzględnia filtry i zwraca tylko zasoby widoczne dla konta powiązanego z kluczem.
EFEKT
Nie zmienia zasobów ani nie uruchamia publikacji.
POWTÓRKA
Operację można bezpiecznie powtórzyć. Na 429 lub 5xx użyj wykładniczego wycofywania z jitterem.
Żądanie
limitinteger · queryIlość na stronę.min 1 · max 100 · default 30opcjonalneoffsetinteger · queryPrzesunięcie paginacji.min 0 · default 0opcjonalneAuthorization
Bearer ach_live_...Accept
application/jsonZakres
groups:readPrzykład wykonywalny
curl
curl 'https://achadu.com/api/v1/groups' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json'Odpowiedź i błędy
Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.
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..."
}200Operacja zakończona.400Nieprawidłowy parametr, treść lub przejście.401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.402Plan konta nie udostępnia tego interfejsu.403A chave precisa do escopo groups:read.404Funkcja nie istnieje na tym koncie.409Obecny stan uniemożliwia tę operację.413Treść JSON przekracza 128 KB.429Przekroczono okno 120 żądań na minutę.