Διαβάστε κάθε σελίδα, τηρήστε τα όρια ρυθμού και ανακτήστε με ασφάλεια από σφάλματα.
Όρια ρυθμού
Τα όρια μπορούν να διαμορφωθούν. Το GET /v1/operations/capabilities αναφέρει requestsPerMinute και authenticationRequestsPerMinutePerIp. Μετά από ένα 429, τιμήστε την επιλογή Retry-After και περιμένετε περισσότερο εάν ο περιορισμός συνεχίζεται. Οι μαζικές αναγνώσεις δέχονται έως και 100 ID. Τα μεμονωμένα τελικά σημεία ενδέχεται να έχουν μικρότερα όρια σελίδας ή ωφέλιμου φορτίου.
Διαβάστε κάθε σελίδα
Χρησιμοποιήστε τον κανόνα συνέχειας για το τελικό σημείο που καλέσατε, διατηρώντας τα ίδια φίλτρα. Οι λίστες μπορούν να αλλάξουν ενώ τις διαβάζετε. Χρησιμοποιήστε στιγμιότυπα όταν χρειάζεστε ένα συνεπές αντίγραφο.
Σελιδοποίηση Συνέχεια με Σταματήστε όταν Δρομέας Περάστε το next ως after. επόμενο είναι το null. Μετατόπιση με nextOffset Περάστε το nextOffset ως offset. Το nextOffset είναι null. Μετατόπιση με hasMore Αυξήστε την μετατόπιση κατά τον αριθμό των επιστρεφόμενων στοιχείων. Το hasMore είναι ψευδές. Λογισμικό Διαβιβάστε την αριθμητική τιμή next ως after. Επανεκκινήστε εάν το updatedAtUtc αλλάξει. επόμενο είναι το null. Τροφοδοσία συμβάντος Περάστε το next ως after. Το hasMore είναι ψευδές. Χειρισμός σφαλμάτων
Διαβάστε τον κωδικό σφάλματος καθώς και την κατάσταση HTTP. Εάν η απάντηση περιλαμβάνει το requestId, αναφέρετέ το όταν επικοινωνείτε με την υποστήριξη.
Κατάσταση HTTP Τι πρέπει να κάνετε 400 Διορθώστε το αίτημα. 401 Ελέγξτε τα διαπιστευτήρια ή αποκτήστε ένα νέο διακριτικό πρόσβασης. 403 Ελέγξτε το εύρος, τα δικαιώματα και εάν η πρόσβαση είναι ενεργοποιημένη. 404 Ο πόρος ενδέχεται να λείπει ή να βρίσκεται εκτός του πεδίου εφαρμογής σας. 409 Διαβάστε τον κωδικό σφάλματος και την τρέχουσα κατάσταση πριν αποφασίσετε. 410 Ο κέρσορας στιγμιότυπου ή συμβάντος έληξε. Ξεκινήστε μια νέα γραμμή βάσης. Εάν λήξει το χρονικό όριο μιας εγγραφής
Ένα χρονικό όριο ή ένα σφάλμα 503 δεν αποδεικνύει ότι η ενέργεια απέτυχε. Για εγγραφές που επιστρέφουν αποδείξεις λειτουργίας, αναζητήστε GET /v1/operations/by-key?idempotencyKey={key} πριν προσπαθήσετε ξανά. Για δημιουργία συντήρησης, επαναχρησιμοποιήστε το αρχικό Idempotency-Key και το σώμα.