/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ă.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.apikey:secret sau secret:).
Setați BASE la gazda regională a organizației — consultați
Regiuni.
Parcurgerea unei liste
ÎncărcațiLIVING_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 filtrutype la pagina a doua — returnează un 400 cu codul
invalid_request pentru parametrul page_token:
400 Invalid request
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. Pentru429, 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.
