Événements

Un événement est une entrée du journal d'activité du projet. Chaque changement effectué depuis l'espace de travail ou par l'API est consigné, et cette ressource lit ce journal. Les événements sont écrits par le système : il n'existe aucun appel permettant d'en créer, d'en modifier ou d'en supprimer un.

Les appels

<event_id> est un identifiant d'événement, préfixé evnt_.

L'objet événement

related.table nomme le genre d'enregistrement et related.id l'enregistrement lui-même : vous pouvez donc remonter d'un événement à l'application, la clé, le fichier ou l'adhésion qu'il concerne. Il n'y a pas d'updated_at : un événement est écrit une fois et n'est jamais révisé.

Note — details est une valeur JSON décodée, jamais une chaîne. Lisez-le comme un conteneur et testez la présence de la clé qui vous intéresse plutôt que de le comparer à "". La plupart des événements ne consignent aucun contexte supplémentaire, et un contexte vide revient sous la forme [].

Lister les événements

GET /v1/event renvoie les événements du projet, les plus récents d'abord, au plus 100.

curl https://api.think.ultineo.com/v1/event \
  -H "Authorization: Bearer sk-project-YOUR_KEY"

{
  "code": 200,
  "title": "OK",
  "response": {
    "object": "list",
    "data": [
      {
        "id": "evnt_c3f80a25e719bd46a08f",
        "object": "event",
        "type": {
          "id": "evty_48b62f75d0fe49d4db23",
          "name": "File deleted"
        },
        "related": {
          "table": "file",
          "id": "file_d81e4afa6c8bf11fa881"
        },
        "origin": "api",
        "ip_address": "203.0.113.24",
        "details": [],
        "created_at": 1754209800
      }
    ],
    "total": 1
  }
}

Consulter un événement

GET /v1/event/<event_id> renvoie un seul événement de votre projet. Un événement d'un autre projet donne 404 et Event not found.

curl https://api.think.ultineo.com/v1/event/evnt_c3f80a25e719bd46a08f \
  -H "Authorization: Bearer sk-project-YOUR_KEY"

Note — Le listage est plafonné aux 100 événements les plus récents et n'accepte aucun paramètre de pagination : c'est donc un flux d'activité récente plutôt qu'un historique complet. Relevez les événements qui vous importent à mesure qu'ils apparaissent si vous souhaitez les conserver.

origin vous indique de quelle surface vient un changement : une entrée faite par l'une de vos clés se distingue donc de celle qu'un collègue a faite depuis l'espace de travail.