/v1 liste uç noktası aynı zarfı döndürür ve aynı şekilde sayfalama yapar:
belirteç tabanlı, yalnızca ileri yönlü.
Liste zarfı
string
Her zaman
"list".array
Kaynakların sayfası; sabit ve belirlenimci bir sırada.
string | null
Sonraki sayfayı almak için bunu bir sonraki istekte
page_token olarak iletin.
Başka sonuç kalmadığında null olur.boolean
Bu sayfanın ötesinde başka sonuçların bulunup bulunmadığını belirtir.
İstek parametreleri
integer
varsayılan:"25"
Sayfa boyutu. 1 ile 500 arasında bir tam sayı. Bu aralığın dışındaki değerler,
invalid_request koduyla
bir 400 döndürür.string
Önceki yanıttaki
next_page_token. İlk sayfa için bu parametreyi kullanmayın.İstisna:
GET /v1/cohorts/{id}/members, daha yüksek bir limit istenmiş olsa bile sayfa başına en fazla 50 satır döndürür. has_more ve
next_page_token yine de Grup içinde kalan gerçek miktarı yansıtır.apikey:secret veya secret:).
BASE değerini kuruluşun bölgesel ana bilgisayarına ayarlayın — bkz.
Bölgeler.
Bir listede gezinme
LIVING_SECURITY_API_KEY değerini, hızlı başlangıçta olduğu gibi gizli anahtar yöneticinizden yükleyin.
Bu örnek için entity:read gerekir; ilk istek kılavuzunda kullanılan anahtar için bu ek yetkinin
verilmesi gerekebilir. Python için requests, kabuk örneği için jq yükleyin. Her iki örnek de bir sürüme sabitlenir, filtreleri değiştirmez ve yönlendirmeleri reddeder. Kısmi bir gezinmeyi tamamlanmış olarak bildirmek yerine hatalarda ve 1.000 sayfadan sonra durur. Python’ın okuma zaman aşımı toplam iş süresini değil, hareketsizlik süresini sınırlar; entegrasyonunuzda bir iş son tarihi belirleyin.
next_page_token değeri null olana kadar sayfaları isteyin. Koleksiyonu daha az istekle kapsamak için toplu
okumalarda limit=500 kullanmayı tercih edin — bkz.
hız sınırları.
Sayfalama sırasında filtreleri sabit tutun
Sayfa belirteçleri opak, imzalı imleçlerdir. Her belirteç; kuruluşa, kimliği doğrulanmış hizmet hesabına, sözleşme sürümüne ve kendisini üreten isteğin tam filtre kümesine bağlıdır. Gezinme sırasında bunlardan herhangi birini değiştirmek — örneğin ikinci sayfada birtype filtresi eklemek — page_token parametresi için invalid_request koduyla bir 400 döndürür:
400 Invalid request
Liste uç noktaları, desteklemedikleri sorgu parametrelerini parametreyi belirten bir
400
invalid_request ile reddeder. Desteklenen filtreler için her uç noktanın referansına bakın.Yarıda kesilen veya değişen bir koleksiyonu yönetme
Bu örnekler hataları otomatik olarak yeniden denemez.429 için Retry-After değerine uyun
ve sınırlı yeniden deneme yönergelerini izleyin. Bir okumayı yeniden denerken
aynı bölgeyi, hizmet hesabını, sürümü, filtreleri ve son başarıyla işlenen sayfa belirtecini kullanın. Kimlik bilgilerini değiştirmek erişim sağlamaz:
her istek güncel izinleri yine denetler.
Çok sayfalı bir okuma, koleksiyonun anlık görüntüsü değildir. Gezinirken satırlar
değişebilir. Kaynakları sabit id değerleriyle işleyin ve aşağı akış
yazma işlemlerini idempotent hale getirin; yeniden başlatma bir satırı tekrar döndürebilir. Bir belirteç reddedilirse,
baştan başlamadan önce page_token hatasını inceleyin ve isteği düzeltin. Daha önce işlenmiş verileri sessizce atmayın veya yarıda kalmış bir dışa aktarmayı tamamlanmış olarak işaretlemeyin. Kesin raporlama toplamları için canlı bir liste gezinmesini anlık görüntü olarak değerlendirmek yerine uygun raporlama kaynağını kullanın.
