> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/server/http-tracking-api/http-tracking-api1_0.md).

# (obsolète) source API de tracking HTTP 1.0

{% hint style="danger" %}
Vous consultez l’ancienne version de l’API (version 1.0)\
Commanders Act mettra fin au support et à la maintenance de la source HTTP tracking API 1.0 le 31 août 2023.\
**Cette API sera totalement dépréciée en décembre 2023**. Après cette date, le format actuel ne sera plus pris en charge et toute requête l’utilisant pourra générer des erreurs.

Nous vous encourageons à commencer à utiliser le nouveau format payload dès que possible afin d’assurer une transition en douceur. Le nouveau format est décrit [ici](/fr/fonctionnalites/sources/sources-catalog/server/http-tracking-api.md#track). Veuillez consulter notre documentation pour plus d’informations sur la manière d’utiliser le nouveau format.
{% endhint %}

{% hint style="warning" %}
Ce qui a changé dans le format payload de la version 1.0 à la version 2.0 :

1. Toutes les données d’événement se trouvaient dans le **`properties`** objet. Elles se trouvent désormais à la racine. Le `properties` cet objet n’existe plus.
2. Toutes les métadonnées contextuelles se trouvaient à la racine, elles se trouvent désormais dans un nouveau **`context`** objet. Par exemple, ces objets de métadonnées `event_id`, `device`, `page`, `app`, `event_timestamp` se trouvent désormais dans le `context` objet.
   {% endhint %}

L’API HTTP Tracking 1.0 vous permet d’enregistrer des données depuis n’importe quel site web ou application. Les requêtes sont acheminées vers nos serveurs, et vos données sont acheminées vers toute destination de votre choix.

## Configuration

### En-têtes

#### Authentification

Authentifiez-vous auprès de l’API de tracking en envoyant la **Clé source** avec une requête dans les en-têtes, comme ceci : `Authorization: Bearer NJtcKaoCYu...mGZDxRgMBMUw==`

{% hint style="info" %}
La clé source vous est fournie lorsque vous créez une source dans le [`catalogue des sources`](/fr/fonctionnalites/sources/sources-catalog.md)
{% endhint %}

#### Content-Type <a href="#content-type" id="content-type"></a>

Pour envoyer des données à notre API HTTP, l’en-tête Content-Type doit être défini sur `'application/json'`.

### Erreurs

Nous renvoyons actuellement une réponse 200 pour toutes les requêtes API ; le débogage doit donc être effectué via l’interface de la plateforme ou notre [API de configuration](/fr/developpeurs/config-api.md) (inspecteur d’événements ou API de livraison d’événements). La seule exception est que si la requête est trop volumineuse ou si le JSON est invalide, elle renverra une erreur 400.

### Taille maximale de la requête <a href="#max-request-size" id="max-request-size"></a>

La taille maximale est de `32KB` par requête API.

### Limite de débit

Il n’existe pas de véritable limite de débit au-delà de laquelle le système rejettera vos données. Mais si vous devez importer à un rythme supérieur à **500 requêtes par seconde**, veuillez [nous contacter](mailto:support@commandersact.com) au préalable.

## API d’événements <a href="#track" id="track"></a>

Vous pouvez utiliser l’API d’événements pour capturer les actions effectuées par vos utilisateurs. Chaque action donne lieu à ce que l’on appelle un « événement », qui possède des propriétés associées.

Vous devez suivre les activités qui indiquent les performances de votre application, telles que l’inscription, l’achat d’un article et l’ajout d’un article aux favoris. Pour commencer, nous recommandons de suivre seulement quelques événements clés. D’autres pourront facilement être ajoutés plus tard !

Exemple `événement` appel : <mark style="color:red;">**(**</mark>[<mark style="color:red;">**obsolète**</mark>](#user-content-fn-1)[^1]<mark style="color:red;">**)**</mark>

```c
POST  https://collect.commander1.com/events?tc_s={siteId}
```

```json
{
  "event_name": "search",
  "event_id": "202110130000000000",
  "event_timestamp": 1639044446636,
  "properties": {
      "search_term": "t-shirts", 
      "user": {
          "id": "12345",
          "email":"toto@domain.fr",
          "consent_categories": [1,3]
      }
  },
  "page": {
    "title": "Search page",
    "location": "https://shop.com/search?q=..."
  },
  "device": {
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.86 Safari/537.36",
    "ip": "102.3.4.56", 
    "cookie":"_fbp=123; _fbc=456; _ga=789"
 }
}
```

Voir les détails sur **les bonnes pratiques pour nommer les événements** ainsi que le **`événement` payload de la méthode** dans notre [Spec](/fr/developpeurs/tracking-and-integrations/tracking/about-events.md).

{% hint style="info" %}
Si vous souhaitez utiliser l’API de tracking HTTP depuis votre application mobile au lieu du SDK, consultez la [Spécificités des événements mobiles](/fr/developpeurs/tracking-and-integrations/tracking/about-events/mobile-sdk-event-specificity.md)
{% endhint %}

{% hint style="info" %}
Les timestamps pris en charge sont en millisecondes (ms).
{% endhint %}

[^1]: Voir les informations en haut de la page


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/server/http-tracking-api/http-tracking-api1_0.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.