Skip to main content
Her /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.
Offset parametreleri, önceki sayfaya geçiş ve kesin toplam sayılar yoktur. Bir koleksiyonu saymak için koleksiyonun tamamında gezinin.
İ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.
İki Basic kimlik bilgisi biçiminden herhangi biriyle kimlik doğrulaması yapın — bkz. Hızlı Başlangıç (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 bir type filtresi eklemek — page_token parametresi için invalid_request koduyla bir 400 döndürür:
400 Invalid request
Filtreleri değiştirmek için ilk sayfadan yeni bir gezinme başlatın.
page_token değerini opak bir dize olarak değerlendirin: aldığınız şekliyle aynen geri iletin. Belirteçlerin kodunu çözmeyin, uzun süreli saklamayın veya kendiniz oluşturmayın — iç biçimleri önceden haber verilmeksizin her an değişebilir.
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.