Skip to main content
Har bir /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.
Offset parametrlari, oldingi sahifaga o‘tish imkoniyati va aniq umumiy sonlar mavjud emas. To‘plamdagi elementlarni sanash uchun uni boshidan oxirigacha o‘qib chiqing.
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.
Basic autentifikatsiyaning istalgan ikki shaklidan biri bilan autentifikatsiyadan o‘ting — qarang: Quickstart (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 sahifada type filtrini qo‘shish — page_token parametri bo‘yicha invalid_request kodli 400 xatosini qaytaradi:
400 Invalid request
Filtrlarni o‘zgartirish uchun birinchi sahifadan boshlab yangi o‘qishni boshlang.
page_token ni noaniq satr sifatida qabul qiling: uni aynan olingan ko‘rinishda qaytarib yuboring. Tokenlarni dekodlamang, uzoq muddat saqlamang va o‘zingiz yasamang — ularning ichki formati istalgan vaqtda ogohlantirishsiz o‘zgarishi mumkin.
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.