Lister les événements

Paramètres

Lingara-Versionheaderstringfacultatif

La version de l'API sous laquelle traiter cette requête. Sans elle, un jeton d'accès obtient la version à laquelle son client est rattaché, et une requête sans jeton obtient la version actuelle. La version encore en développement ne s'atteint qu'en la nommant ici. Une version inconnue répond 400 avec le code api_version_unknown. GET /v1/versions liste les versions.

cursorquerystringfacultatif

Où reprendre : le next_cursor d'une page précédente, ou l'id: d'un événement du flux. Un curseur de plus de 30 jours reçoit 410 avec le code cursor_expired.

startquerystringfacultatif

Où commencer sans curseur : latest pour les événements à partir de maintenant, ou oldest pour tous les événements encore conservés.

typesqueryarray of stringfacultatif

Uniquement ces types d'événements, séparés par des virgules. Sans ce paramètre, tous les types que les portées de votre jeton peuvent lire.

limitqueryintegerfacultatif

Le nombre maximal d'événements renvoyés par page, de 1 à 100.

Réponses

200 Une page d'événements et le curseur à partir duquel continuer

itemsarray of EventEnvelopeobligatoire

idstringobligatoire

typestringobligatoire

created_atstringobligatoire

api_versionstringobligatoire

subjectstringobligatoire

dataobjectobligatoire

next_cursorstringobligatoire

has_morebooleanobligatoire

Erreurs

410application/json

api_version_discontinued : la version de l'API de cette requête a été retirée. cursor_expired : le curseur a plus de 30 jours ; recommencez sans curseur.

4XXapplication/json

La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.

503application/json · text/plain

Le service est temporairement indisponible ; réessayez après le nombre de secondes indiqué dans Retry-After. Pendant la maintenance, le corps est du texte brut plutôt que l'enveloppe d'erreur.

5XXapplication/json

La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.

codestringobligatoire

Pourquoi la requête a été refusée, sous forme de code stable sur lequel brancher votre logique : par exemple insufficient_scope (403), rate_limited (429) et, pour un client facturé à l'usage, spend_cap_reached (402) et metered_billing_inactive (402).

errorstringobligatoire

Exemple

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

Vous préférez une bibliothèque ? Consultez la section Bibliothèques.