API - Track History

1. Présentation

Notre API est destinée à un usage purement professionnel, elle permet la communication en S2S (server-to-server) entre votre serveur et le serveur de Track History.

Le principal avantage de l'API est l'automatisation de vos évènements. Si vous possédez un site ou une plateforme qui effectue des transactions en temps réel, vous n'allez bien sûr pas rester derrière pour reporter chaque transaction à la main sur votre compte Track History.

En outre, l'API vous permet aussi de :

Lister vos évènements
Gérer vos groupes
Gérer vos catégories
Gérer vos types de valeurs

2. Prérequis

Posséder un serveur capable d'envoyer des requêtes HTTP
Acheter des requêtes API sur Track History
Avoir quelques connaissances techniques ou embaucher un développeur *

* En l'absence de développeur, nous pouvons nous occuper de l'installation si votre infrastructure nous le permet. Ceci est toutefois un service payant.

3. Étapes pour obtenir une clef privée

Créer un compte sur Track History
Acheter des requêtes API
Rendez-vous sur Mes comptes API
Assurez-vous d'avoir au moins un compte Actif
Copiez la clef privée

La clef privée n'est affichée que partiellement sur l'interface ! Cliquez dessus vous permettra de la copier intégralement.

Attention ! Une clef privée doit être uniquement utilisé côté backend. Ne l'utilisez pas sur du frontend (html, js, ou tout code pouvant être lu directement sur le navigateur).

N'utilisez l'API que si vous savez exactement ce que vous faites, c'est un risque de sécurité potentiel pour votre compte Track History.

4. Comment utiliser la clef dans vos requêtes

Envoyez votre clef privée dans l'en-tête Authorization, en Bearer. L'en-tête X-Api-Key est accepté aussi. Ne la passez jamais dans l'URL : elle finirait dans les journaux des serveurs.

Dans les exemples ci-dessous, remplacez votre_clef_privee par la clef privée que vous avez copiée.

1. En-tête Authorization (recommandé)

curl https://api.track-history.com/event \
  -H "Authorization: Bearer votre_clef_privee"

2. En-tête X-Api-Key

curl https://api.track-history.com/event \
  -H "X-Api-Key: votre_clef_privee"

Chaque requête faite avec une clef décompte une requête de votre stock. Une fois le stock épuisé, l'API répond 401 avec l'erreur api_request_limit_reached.

5. Requêtes

URL d'accès à l'API : https://api.track-history.com

Les paramètres envoyés et les réponses sont toujours en JSON : Content-Type: application/json

Les dates s'écrivent AAAA-MM-JJ HH:MM:SS, en heure locale, sans fuseau.
Une création répond 201 avec l'objet créé, identifiant compris.
Une mise à jour (PATCH) ne modifie que les champs envoyés et répond avec l'objet à jour.
Une suppression répond {"success": true}.
Les listes (defaultValues, values) remplacent la liste existante quand elles sont envoyées : gardez l'id des éléments à conserver.

Erreurs

Une erreur répond avec un code HTTP et un objet error qui en donne la raison :

{
    "error": "event_not_found"
}

400 données invalides, par exemple un évènement accompli sans date de fin (ending_date_required)
401 clef absente, invalide, ou stock de requêtes épuisé (api_request_limit_reached)
402 limite de votre formule atteinte, par exemple le nombre de groupes
404 ressource introuvable sur votre compte

> Groupe

Nom	Route	Paramètres / Réponse
Liste des groupes	`GET /event-group`	Réponse `[ { "id": 1, "name": "Dépenses", "description": "Analyser les sommes utilisées chaque mois", "photoId": null, "defaultValues": [ { "id": 7, "eventValueTypeId": 3, "value": "10" } ] } ]`
Compter les groupes	`GET /event-group/count`	Réponse `1`
Récupérer un groupe	`GET /event-group/{id}`	Réponse : un objet groupe, comme dans la liste
Créer un groupe	`POST /event-group`	Paramètres `{ "name": "Dépenses", "description": "Analyser les sommes utilisées chaque mois", "defaultValues": [ { "eventValueTypeId": 3, "value": "10" } ] }` Réponse (201) : le groupe créé, au même format que GET /event-group/{id}
Mettre à jour un groupe	`PATCH /event-group/{id}`	Mêmes paramètres que la création, tous facultatifs. Réponse : l'objet à jour.
Supprimer un groupe	`DELETE /event-group/{id}`	Réponse `{"success": true}`

> Catégorie

Nom	Route	Paramètres / Réponse
Liste des catégories	`GET /event-type`	Réponse `[ { "id": 32, "name": "Loyer", "description": "850 €/mois", "eventGroupId": 1, "photoId": null, "defaultValues": [] } ]`
Récupérer une catégorie	`GET /event-type/{id}`	Réponse : un objet catégorie, comme dans la liste
Créer une catégorie	`POST /event-type`	Paramètres `{ "name": "Loyer", "description": "850 €/mois", "eventGroupId": 1, "defaultValues": [] }` Réponse (201) : la catégorie créée, au même format que GET /event-type/{id}
Mettre à jour une catégorie	`PATCH /event-type/{id}`	Mêmes paramètres que la création, tous facultatifs. Réponse : l'objet à jour.
Supprimer une catégorie	`DELETE /event-type/{id}`	Réponse `{"success": true}`

> Type de valeur

Nom	Route	Paramètres / Réponse
Liste des types de valeurs	`GET /event-value-type`	Réponse `[ { "id": 3, "name": "Montant", "symbol": "€", "totalFormula": "sum", "criticalMin": null, "criticalMax": "1000" } ]` `totalFormula` : comment les valeurs se totalisent, parmi `sum`, `avg`, `median`, `min`, `max`, `count`, `first`, `last`.
Récupérer un type de valeur	`GET /event-value-type/{id}`	Réponse : un objet type de valeur, comme dans la liste
Créer un type de valeur	`POST /event-value-type`	Paramètres `{ "name": "Montant", "symbol": "€", "totalFormula": "sum", "criticalMin": null, "criticalMax": "1000" }` Réponse (201) : le type de valeur créé, au même format que GET /event-value-type/{id}
Mettre à jour un type de valeur	`PATCH /event-value-type/{id}`	Mêmes paramètres que la création, tous facultatifs. Réponse : l'objet à jour.
Supprimer un type de valeur	`DELETE /event-value-type/{id}`	Réponse `{"success": true}`

> Évènement

Nom	Route	Paramètres / Réponse
Liste des évènements	`GET /event`	Paramètres de requête, tous facultatifs : `limit`, `offset` : pagination (sans limit, tous les évènements) `sort` : `DESC` (par défaut) ou `ASC`, par date de début `trackingStartingDate`, `trackingEndingDate` : bornes de la période `eventGroupIds`, `eventTypeIds`, `eventValueTypeIds`, `status` : listes séparées par des virgules `identifier` : les évènements de cet identifiant exactement `keyword` : recherche dans le nom, la description, l'identifiant, le groupe, la catégorie et les types de valeurs Réponse [ { "id": 2356, "name": "Loyer de juillet", "description": "Le propriétaire a encore augmenté les prix", "identifier": "flat-12", "status": "normal", "selfFulfilled": false, "trackingStartingDate": "2026-07-01 00:00:00", "trackingEndingDate": "2026-07-31 23:59:59", "notificationDate": null, "eventGroupId": 1, "eventGroupName": "Dépenses", "eventTypeId": 32, "eventTypeName": "Loyer", "apiAccountId": 4, "photoId": null, "fileCount": 0, "values": [ { "id": 911, "eventValueTypeId": 3, "eventValueTypeName": "Montant", "eventValueTypeSymbol": "€", "value": "850" } ], "creationDate": "2026-07-01 08:12:40", "updateDate": "2026-07-01 08:12:40" } ]
Compter les évènements	`GET /event/count`	Accepte les mêmes filtres que la liste. `496`
Récupérer un évènement	`GET /event/{id}`	Réponse : un objet évènement, comme dans la liste
Créer un évènement	`POST /event`	Paramètres `{ "name": "Loyer de juillet", "description": "Le propriétaire a encore augmenté les prix", "identifier": "flat-12", "status": "normal", "selfFulfilled": false, "trackingStartingDate": "2026-07-01 00:00:00", "trackingEndingDate": "2026-07-31 23:59:59", "eventGroupId": 1, "eventTypeId": 32, "values": [ { "eventValueTypeId": 3, "value": "850" } ] }` `status` : `normal`, `awaiting`, `fulfilled` ou `missed`. Sans `trackingStartingDate` ni `trackingEndingDate`, l'évènement commence et finit maintenant ; `"trackingEndingDate": null` le laisse en cours. Un évènement `fulfilled` doit avoir une date de fin. « identifier » est facultatif et libre : ce que l'évènement concerne (un joueur, une machine, une commande…). Deux évènements au même identifiant concernent la même chose, ce qui permet de compter des identifiants distincts et de filtrer avec GET /event?identifier=… Réponse (201) : l'évènement créé, au même format que GET /event/{id}
Mettre à jour un évènement	`PATCH /event/{id}`	Mêmes paramètres que la création, tous facultatifs. Envoyer `"identifier": null` retire l'identifiant. Une clef ne peut modifier ou supprimer que les évènements qu'elle a créés et ceux saisis dans l'application. Réponse : l'objet à jour.
Supprimer un évènement	`DELETE /event/{id}`	Réponse `{"success": true}`

Documentation API