Skip to main content
Fiecare endpoint de tip listă /v1 returnează același înveliș și realizează paginarea în același mod: bazată pe token, doar înainte.

Învelișul listei

string
Întotdeauna "list".
array
Pagina de resurse, într-o ordine stabilă și deterministă.
string | null
Transmiteți această valoare ca page_token în cererea următoare pentru a obține pagina următoare. null când nu mai există rezultate.
boolean
Indică dacă există rezultate suplimentare după această pagină.

Parametrii cererii

integer
implicit:"25"
Dimensiunea paginii. Un număr întreg între 1 și 500. Valorile din afara acestui interval returnează un 400 cu codul invalid_request.
string
Valoarea next_page_token din răspunsul anterior. Omiteți-o pentru prima pagină.
Nu există parametri de tip offset, nici parcurgere spre pagina anterioară, nici totaluri exacte. Pentru a număra elementele unei colecții, parcurgeți-o integral.
Excepție: GET /v1/cohorts/{id}/members returnează cel mult 50 de rânduri pe pagină, chiar dacă solicitați un limit mai mare. has_more și next_page_token reflectă în continuare restul real al cohortei.
Autentificați-vă cu oricare dintre cele două forme de credențiale Basic — consultați Ghid de pornire rapidă (apikey:secret sau secret:). Setați BASE la gazda regională a organizației — consultați Regiuni.

Parcurgerea unei liste

Încărcați LIVING_SECURITY_API_KEY din managerul dvs. de secrete, ca în ghidul de pornire rapidă. Acest exemplu necesită entity:read; este posibil ca cheia utilizată în ghidul primei cereri să necesite această permisiune suplimentară. Instalați requests pentru Python sau jq pentru exemplul de shell. Ambele exemple fixează o versiune, păstrează filtrele neschimbate și resping redirecționările. Se opresc la erori și după 1.000 de pagini, în loc să raporteze o parcurgere parțială drept completă. Timpul de citire (read timeout) din Python limitează inactivitatea, nu durata totală a sarcinii; stabiliți un termen limită pentru sarcină în integrarea dvs. Solicitați pagini până când next_page_token este null. Preferați limit=500 pentru citiri în volum mare, astfel încât să acoperiți colecția cu mai puține cereri — consultați limitele de rată.

Mențineți filtrele neschimbate pe durata paginării

Tokenurile de pagină sunt cursoare opace, semnate. Fiecare token este asociat organizației, contului de serviciu autentificat, versiunii contractului și setului exact de filtre din cererea care l-a generat. Modificarea oricăruia dintre acestea în timpul parcurgerii — de exemplu, adăugarea unui filtru type la pagina a doua — returnează un 400 cu codul invalid_request pentru parametrul page_token:
400 Invalid request
Pentru a schimba filtrele, începeți o parcurgere nouă de la prima pagină.
Tratați page_token ca pe un șir opac: transmiteți-l înapoi exact așa cum l-ați primit. Nu decodați, nu stocați pe termen lung și nu construiți tokenuri — formatul lor intern se poate modifica în orice moment, fără notificare prealabilă.
Endpointurile de tip listă resping parametrii de interogare pe care nu îi acceptă cu un 400 invalid_request care indică parametrul respectiv. Consultați referința fiecărui endpoint pentru filtrele acceptate.

Gestionarea unei colecții întrerupte sau aflate în schimbare

Aceste exemple nu reîncearcă automat cererile care returnează erori. Pentru 429, respectați Retry-After și urmați recomandările privind reîncercările, care sunt limitate. Păstrați aceeași regiune, același cont de serviciu, aceeași versiune, aceleași filtre și ultimul token de pagină procesat cu succes atunci când reîncercați o citire. Schimbarea credențialelor nu acordă acces: fiecare cerere verifică în continuare permisiunile curente. O citire pe mai multe pagini nu reprezintă un instantaneu al colecției. Rândurile se pot modifica în timp ce o parcurgeți. Procesați resursele după id lor stabil și faceți scrierile din aval idempotente; o repornire poate returna din nou un rând. Dacă un token este respins, analizați eroarea page_token și corectați cererea înainte de a relua de la prima pagină. Nu eliminați în mod tacit datele procesate anterior și nu marcați o exportare întreruptă drept finalizată. Pentru totaluri exacte în rapoarte, utilizați resursa de raportare adecvată, în loc să tratați o parcurgere a unei liste în timp real drept instantaneu.