Lisez les données de votre organisation depuis vos propres outils (CRM, comptabilité, tableau de bord) et recevez chaque nouvelle inscription, paiement ou présence en temps réel. L'API est en lecture seule et réservée aux organisations en formule Pro ou Sur mesure.
Créez une clé dans Organisation → Intégrations. Elle n'est affichée qu'une seule fois : rangez-la côté serveur, jamais dans une application mobile ou une page web. Chaque clé porte des droits (un par type de données) ; une route hors de ses droits répond 403.
Par clé : 60 requêtes par minute et 10 000 par jour. Au-delà, la réponse est 429 Too Many Requests avec un en-tête Retry-After (en secondes) : attendez ce délai avant de réessayer.
HTTP/1.1 429 Too Many Requests
Retry-After: 23
Content-Type: application/json
{"detail": "…", "retry_after": 23}
Pagination
Les listes sont paginées par curseur, 100 éléments par page, du plus ancien au plus récent. Suivez l'URL next telle quelle jusqu'à ce qu'elle vaille null ; ne construisez pas le paramètre cursor vous-même.
let url = "https://api.teriya-events.com/api/v1/events/123/registrations/?updated_since=2026-10-01T00:00:00Z";
while (url) {
const r = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TERIYA_API_KEY}` } });
if (r.status === 429) {
await new Promise((ok) => setTimeout(ok, Number(r.headers.get("Retry-After") ?? 60) * 1000));
continue;
}
const page = await r.json();
for (const inscrit of page.results) traiter(inscrit);
url = page.next; // null sur la dernière page
}
Formats
Dates et heures en ISO 8601 avec fuseau (2026-11-14T09:00:00+00:00).
Montants en chaînes décimales ("25000.00"), jamais en nombres flottants ; la devise est dans currency.
Un champ sans valeur vaut null.
Un événement d'une autre organisation répond 404.
Routes
GET/api/v1/events/
Les événements de l'organisation.
Droit requis : events:read
Paramètres
updated_since
Date ISO 8601 : seulement les éléments modifiés depuis (synchronisation incrémentale).
La clé n'a pas le droit demandé, ou l'organisation n'a plus la formule Pro.
404
Événement inconnu ou d'une autre organisation.
400
Paramètre invalide (updated_since non ISO 8601…).
429
Limite atteinte : attendre Retry-After secondes.
Webhooks
Ajoutez une adresse https publique dans Organisation → Intégrations et cochez les événements voulus. Les adresses privées ou locales sont refusées. Le secret de signature (whsec_…) n'est affiché qu'une fois, à la création. « Envoyer un test » expédie un événement ping signé.
Événements
registration.confirmed
Une inscription est confirmée.
registration.cancelled
Une inscription est annulée.
payment.completed
Un paiement est reçu.
payment.refunded
Un paiement est remboursé.
checkin.created
Une présence est enregistrée (hors doublons).
stand.confirmed
Une réservation de stand est confirmée.
En-têtes
X-Teriya-Signature
t=<horodatage Unix>,v1=<HMAC-SHA256(secret, t + "." + corps)>, en hexadécimal.
X-Teriya-Event
Le type d'événement (ou ping pour un test).
X-Teriya-Delivery
L'identifiant de l'envoi, identique d'un réessai à l'autre.
Exemple d'envoi
Le corps est un objet { type, id, created, data } ; data a exactement la forme de l'objet renvoyé par la route correspondante.
Calculez HMAC-SHA256 avec votre secret sur la chaîne `${t}.${corps brut}` (t est l'horodatage de l'en-tête, en secondes), comparez le résultat hexadécimal à v1 en temps constant, et refusez un horodatage écarté de plus de 5 minutes de votre horloge (protection contre le rejeu). Vérifiez sur le corps brut reçu, avant tout décodage JSON.
Node.js
import crypto from "node:crypto";
import express from "express";
const SECRET = process.env.TERIYA_WEBHOOK_SECRET; // whsec_…
const TOLERANCE_S = 300; // 5 minutes
function verifier(entete, corpsBrut, secret) {
// entete = "t=1760180000,v1=5f2b…"
const parts = Object.fromEntries(
entete.split(",").map((p) => {
const i = p.indexOf("=");
return [p.slice(0, i), p.slice(i + 1)];
})
);
const t = Number(parts.t);
if (!Number.isInteger(t) || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - t) > TOLERANCE_S) return false;
// HMAC-SHA256(secret, `${t}.${corpsBrut}`) — sur le corps BRUT, octet pour octet
const attendu = crypto
.createHmac("sha256", secret)
.update(`${t}.`)
.update(corpsBrut)
.digest("hex");
const a = Buffer.from(attendu, "utf8");
const b = Buffer.from(parts.v1, "utf8");
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
const app = express();
// express.raw : surtout pas express.json(), qui re-sérialiserait le corps
app.post("/teriya/webhook", express.raw({ type: "application/json" }), (req, res) => {
if (!verifier(req.get("X-Teriya-Signature") ?? "", req.body, SECRET)) {
return res.sendStatus(400);
}
const evenement = JSON.parse(req.body.toString("utf8"));
// evenement.id est stable d'un réessai à l'autre : dédoublonnez dessus.
console.log(evenement.type, evenement.data);
res.sendStatus(200); // répondre en moins de 10 s
});
app.listen(3000);
Python
import hashlib
import hmac
import json
import os
import time
from flask import Flask, abort, request
SECRET = os.environ["TERIYA_WEBHOOK_SECRET"].encode() # whsec_…
TOLERANCE_S = 300 # 5 minutes
def verifier(entete: str, corps_brut: bytes) -> bool:
# entete = "t=1760180000,v1=5f2b…"
try:
parts = dict(p.split("=", 1) for p in entete.split(","))
t = int(parts["t"])
recu = parts["v1"]
except (KeyError, ValueError):
return False
if abs(time.time() - t) > TOLERANCE_S:
return False
# HMAC-SHA256(secret, f"{t}.{corps_brut}") — sur le corps BRUT
attendu = hmac.new(SECRET, f"{t}.".encode() + corps_brut, hashlib.sha256).hexdigest()
return hmac.compare_digest(attendu, recu) # comparaison à temps constant
app = Flask(__name__)
@app.post("/teriya/webhook")
def webhook():
corps = request.get_data() # octets bruts, avant tout décodage JSON
if not verifier(request.headers.get("X-Teriya-Signature", ""), corps):
abort(400)
evenement = json.loads(corps)
# evenement["id"] est stable d'un réessai à l'autre : dédoublonnez dessus.
print(evenement["type"], evenement["data"])
return "", 200 # répondre en moins de 10 s
Réessais et désactivation
Un envoi réussit quand votre serveur répond 2xx en moins de 10 secondes. Les redirections ne sont pas suivies.
Sinon il est réessayé 1 min, 5 min, 30 min, 2 h puis 12 h plus tard ; après ces cinq réessais, il est marqué en échec.
Une adresse qui échoue sans interruption depuis 3 jours est désactivée, et l'organisation prévenue par e-mail. Réactivez-la depuis l'onglet Intégrations une fois corrigée.
Un même événement peut arriver plus d'une fois (réessai, « Renvoyer ») : dédoublonnez sur le champ id du corps.
L'ordre d'arrivée n'est pas garanti : fiez-vous à updated_at.