/v1 ro‘yxat endpointi bir xil envelope qaytaradi va bir xil
usulda sahifalanadi: token asosida, faqat oldinga yo‘nalishda.
Ro‘yxat envelope’i
string
Doimo
"list".array
Resurslar sahifasi, barqaror va deterministik tartibda.
string | null
Keyingi sahifani olish uchun buni navbatdagi so‘rovda
page_token sifatida yuboring.
Boshqa natijalar qolmaganda null.boolean
Ushbu sahifadan tashqarida yana natijalar mavjudligini bildiradi.
So‘rov parametrlari
integer
standart:"25"
Sahifa hajmi. 1 dan 500 gacha bo‘lgan butun son. Ushbu oraliqdan tashqaridagi qiymatlar
400 va invalid_request kodini qaytaradi.string
Oldingi javobdagi
next_page_token. Birinchi sahifa uchun uni kiritmang.Istisno:
GET /v1/cohorts/{id}/members yuqoriroq limit so‘ralgan taqdirda ham,
har bir sahifada ko‘pi bilan 50 ta qator qaytaradi. has_more va
next_page_token esa Cohort’dagi haqiqiy qoldiqni aks ettirishda davom etadi.apikey:secret yoki secret:).
BASE qiymatini tashkilotning mintaqaviy hostiga o‘rnating — qarang:
Regions.
Ro‘yxatni ketma-ket o‘qish
LIVING_SECURITY_API_KEY qiymatini quickstart’dagi kabi maxfiy ma’lumotlar menejeridan yuklang.
Ushbu misol entity:read ruxsatini talab qiladi; birinchi so‘rov qo‘llanmasida ishlatilgan kalitga
ushbu qo‘shimcha ruxsat berilishi kerak bo‘lishi mumkin. Python uchun requests yoki shell
misoli uchun jq o‘rnating. Ikkala misolda ham versiya qayd etilgan, filtrlar o‘zgarishsiz qoldiriladi va
yo‘naltirishlar (redirect) rad etiladi. Ular qisman o‘qishni to‘liq deb ko‘rsatmaslik uchun xatolarda
va 1 000 sahifadan keyin to‘xtaydi. Python’dagi o‘qish taymauti umumiy ish davomiyligini emas,
faoliyatsizlik vaqtini cheklaydi; integratsiyangizda ish uchun umumiy muddatni belgilang.
next_page_token qiymati null bo‘lguncha sahifalarni so‘rang. Ommaviy o‘qishlarda to‘plamni kamroq so‘rov bilan
qamrab olish uchun limit=500 dan foydalaning — qarang:
rate limits.
Sahifalash davomida filtrlarni o‘zgarishsiz saqlang
Sahifa tokenlari — noaniq, imzolangan kursorlardir. Har bir token tashkilotga, autentifikatsiyadan o‘tgan xizmat akkauntiga, kontrakt versiyasiga va uni yaratgan so‘rovning aniq filtrlar to‘plamiga bog‘langan. O‘qish jarayonida ulardan birortasini o‘zgartirish — masalan, ikkinchi sahifadatype filtrini qo‘shish — page_token parametri bo‘yicha
invalid_request kodli 400 xatosini qaytaradi:
400 Invalid request
Ro‘yxat endpointlari o‘zi qo‘llab-quvvatlamaydigan so‘rov parametrlarini parametr nomi ko‘rsatilgan
400 invalid_request bilan rad etadi. Qo‘llab-quvvatlanadigan filtrlar uchun har bir endpointning
ma’lumotnomasini tekshiring.Uzilgan yoki o‘zgarayotgan to‘plamni qayta ishlash
Ushbu misollar xatolarni avtomatik ravishda qayta urinib ko‘rmaydi.429 uchun Retry-After ga
amal qiling va cheklangan retry guidance ko‘rsatmalariga rioya qiling.
O‘qishni qayta urinayotganda mintaqa, xizmat akkaunti, versiya, filtrlar va oxirgi muvaffaqiyatli
qayta ishlangan sahifa tokenini o‘zgarishsiz saqlang. Hisob ma’lumotlarini almashtirish ruxsat bermaydi:
har bir so‘rovda joriy ruxsatlar baribir tekshiriladi.
Ko‘p sahifali o‘qish to‘plamning oniy nusxasi (snapshot) emas. Siz uni ko‘rib chiqayotganingizda qatorlar
o‘zgarishi mumkin. Resurslarni barqaror id bo‘yicha qayta ishlang va keyingi yozuvlarni
idempotent qiling; qayta boshlash qatorni yana qaytarishi mumkin. Agar token rad etilsa,
birinchi sahifadan qayta boshlashdan oldin page_token xatosini tekshiring va so‘rovni to‘g‘irlang.
Avval qayta ishlangan ma’lumotlarni jimgina tashlab yubormang va uzilgan eksportni tugallangan deb
belgilamang. Hisobotlarning aniq umumiy sonlari uchun jonli ro‘yxat bo‘ylab o‘tishni snapshot deb hisoblamasdan,
tegishli hisobot resursidan foydalaning.
