Λίστα συμβάντων

Παράμετροι

Lingara-Versionheaderstringπροαιρετικό

Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με 400 και κωδικό api_version_unknown. Το GET /v1/versions παραθέτει τις εκδόσεις.

cursorquerystringπροαιρετικό

Από πού να συνεχίσετε: το next_cursor μιας προηγούμενης σελίδας ή το id: ενός συμβάντος ροής. Ένας δείκτης παλαιότερος από 30 ημέρες απαντά 410 με κωδικό cursor_expired.

startquerystringπροαιρετικό

Από πού να ξεκινήσετε χωρίς δείκτη: latest για συμβάντα από τώρα και στο εξής ή oldest για κάθε συμβάν που διατηρείται ακόμη.

typesqueryarray of stringπροαιρετικό

Μόνο αυτοί οι τύποι συμβάντων, χωρισμένοι με κόμματα. Χωρίς αυτό, κάθε τύπος που μπορούν να διαβάσουν τα δικαιώματα του διακριτικού σας.

limitqueryintegerπροαιρετικό

Ο μέγιστος αριθμός συμβάντων ανά σελίδα, από 1 έως 100.

Αποκρίσεις

200 Μια σελίδα συμβάντων και ο δείκτης για να συνεχίσετε

itemsarray of EventEnvelopeυποχρεωτικό

idstringυποχρεωτικό

typestringυποχρεωτικό

created_atstringυποχρεωτικό

api_versionstringυποχρεωτικό

subjectstringυποχρεωτικό

dataobjectυποχρεωτικό

next_cursorstringυποχρεωτικό

has_morebooleanυποχρεωτικό

Σφάλματα

410application/json

api_version_discontinued: η έκδοση API αυτού του αιτήματος έχει καταργηθεί. cursor_expired: ο δείκτης είναι παλαιότερος από 30 ημέρες· ξεκινήστε ξανά χωρίς αυτόν.

4XXapplication/json

Το αίτημα απορρίφθηκε. Το code λέει γιατί και το error το εξηγεί με λόγια.

503application/json · text/plain

Η υπηρεσία δεν είναι προσωρινά διαθέσιμη· δοκιμάστε ξανά μετά τον αριθμό δευτερολέπτων στο Retry-After. Κατά τη συντήρηση, το σώμα είναι απλό κείμενο αντί για τον φάκελο σφάλματος.

5XXapplication/json

Το αίτημα απορρίφθηκε. Το code λέει γιατί και το error το εξηγεί με λόγια.

codestringυποχρεωτικό

Γιατί απορρίφθηκε το αίτημα, ως σταθερός κωδικός για διακλάδωση: για παράδειγμα insufficient_scope (403), rate_limited (429) και, για πελάτη με χρέωση βάσει χρήσης, spend_cap_reached (402) και metered_billing_inactive (402).

errorstringυποχρεωτικό

Παράδειγμα

curl "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Προτιμάτε μια βιβλιοθήκη; Δείτε την ενότητα Βιβλιοθήκες.