Her sayfayı okuyun, hız sınırlarına uyun ve hatalardan güvenli bir şekilde kurtulun.
Hız sınırları
Sınırlar yapılandırılabilir. GET ve /v1/operations/capabilities, requestsPerMinute ve authenticationRequestsPerMinutePerIp'yi rapor eder. 429'dan sonra, Yeniden Dene-Sonra'yı dikkate alın ve kısıtlama devam ederse daha uzun süre bekleyin. Toplu okumalar 100'e kadar kimlik kabul eder; bireysel uç noktaların daha küçük sayfa veya yük sınırları olabilir. (Retry-After)
Her sayfayı okuyun
Çağırdığınız uç nokta için devam kuralını kullanın ve aynı filtreleri koruyun. Listeler okuma sırasında değişebilir; tutarlı bir kopyaya ihtiyacınız olduğunda anlık görüntüler kullanın.
Sayfalama Şununla devam edin: Şu durumda durun: İmleç next'yi after olarak geçirin. Sonraki null'dir. nextOffset ile ofset yapın: nextOffset'yi offset olarak geçirin. nextOffset, null'dir. hasMore ile Ofset İade edilen öğe sayısı kadar ofseti artırın. hasMore yanlıştır. Yazılım Sayısal next değerini after olarak iletin; updatedAtUtc değişirse yeniden başlatın. Sonraki null'dir. Olay akışı next'yi after olarak geçirin. hasMore yanlıştır. Hataları ele alın
Hata kodunu ve HTTP durumunu okuyun. Yanıt requestId içeriyorsa, destek ekibiyle iletişime geçerken bunu belirtin.
HTTP durumu Ne yapılmalı 400 İsteği düzeltin. 401 Kimlik bilgilerini kontrol edin veya yeni bir erişim belirteci alın. 403 Kapsamı, izinleri ve erişimin etkin olup olmadığını kontrol edin. 404 Kaynak eksik olabilir veya kapsamınızın dışında olabilir. 409 Karar vermeden önce hata kodunu ve mevcut durumu okuyun. 410 Anlık görüntü veya olay imleci süresi doldu. Yeni bir temel oluşturun. Yazma işlemi zaman aşımına uğrarsa
Zaman aşımı veya 503 hatası, işlemin başarısız olduğunu kanıtlamaz. İşlem makbuzları döndüren yazma işlemleri için, yeniden denemeden önce GET ve /v1/operations/by-key?idempotencyKey={key}'ye bakın. Bakım oluşturma işlemleri için orijinal Idempotency-Key ve gövdeyi yeniden kullanın.