Aller au contenu
Lexoh API

API des événements

OpenAPI JSON

Consulter l’historique opérationnel

Utilisez /v1/event pour un événement et /v1/event/list pour l’historique filtré. Les deux opérations utilisent POST avec JSON.

POST /v1/event/list

Lister les événements opérationnels

Permissions requises

  • can_view_events

L’authentification, la MFA et les restrictions de portée restent applicables.

Nécessite can_view_events. Transmettez les filtres dans le corps JSON. La réponse contient success, events et count; les résultats non vides comprennent aussi next_cursor.

Corps de la requête JSON

ParamètreTypeDescription
pageintegerNuméro de page; valeur par défaut : 1.
page_limitintegerRésultats par page; valeur par défaut : 25.
searchstringTexte de recherche facultatif.
cursor_idinteger0 commence aux événements les plus récents; next_cursor permet de consulter les plus anciens.
device_idsarray<integer>Filtrer par identifiants d’appareils.
types / event_typesarray<integer>Filtres numériques de type d’événement et de type d’entité.
start_date / end_datestringFiltres de dates facultatifs.

Exemple de requête

curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/event/list" \
  -H "SessionID: SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cursor_id":0,"page_limit":25}'

Exemple de réponse

Exemple sans événement correspondant.

{
  "success": true,
  "events": [],
  "count": 0
}

Lire les champs des événements

  • id et device_id sont des identifiants numériques.
  • type, category et subcategory sont des classifications numériques.
  • name, description et date_at décrivent l’événement enregistré.
  • data est un champ texte; ne présumez pas qu’il s’agit déjà d’un objet JSON décodé.

POST /v1/event

Consulter un événement

Permissions requises

  • can_view_events

L’authentification, la MFA et les restrictions de portée restent applicables.

Transmettez id dans le corps JSON. La même permission de consultation des événements s’applique.

Exemple de requête

curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/event" \
  -H "SessionID: SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":123}'

Distinguer les événements anciens et nouveaux

Les résultats sont classés par identifiant d’événement décroissant. Utilisez next_cursor comme cursor_id pour poursuivre vers les événements plus anciens avec les mêmes filtres. Pour rechercher de nouvelles activités, recommencez avec cursor_id:0 et dédupliquez les événements par id.

Relier l’historique à votre application

Consultez le parcours d’intégration des événements.

Intégrations événementielles →
Appeler Lexoh 1-888-401-8019