Events

Endpoints

GET/v1/events/{event}
GET/v1/events

L’objet Event

Attributs

idstring
Identifiant unique de l'objet (préfixé, opaque).
objectstring
event
typestring
api_versionstring
createdinteger
Time at which the object was created (unix timestamp, seconds).
livemodeboolean
true pour les données réelles, false pour le bac à sable du mode test.
brandstringnullable
La marque à laquelle l'objet appartient (br_…).
dataobject
Afficher les attributs enfants
- objectobject
  Chaîne indiquant le type de l'objet.
- previous_attributesobject

L'objet Event


{
  "id": "evt_034wK3aZBwxdUFxpXoBNdT",
  "object": "event",
  "type": "string",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_034CyfRFSXUqzrbzV6MAfZ",
  "data": {
    "object": {},
    "previous_attributes": {}
  }
}

Retrieve an event

GET/v1/events/{event}

Paramètres

eventstringobligatoire
Event id (evt_…).

Retour

Renvoie l’objet event. Lève une erreur en cas de problème.

curl


curl https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Node.js


const response = await fetch('https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
  },
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('GET', 'events/evt_034wK3aZBwxdUFxpXoBNdT', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.get(
    "https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
)
data = response.json()

Réponse


{
  "id": "evt_034wK3aZBwxdUFxpXoBNdT",
  "object": "event",
  "type": "string",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_034CyfRFSXUqzrbzV6MAfZ",
  "data": {
    "object": {},
    "previous_attributes": {}
  }
}

List events

GET/v1/events

Events of the last 30 days, newest first — the same objects your webhook endpoints receive. Use it to catch up after downtime.