# (deprecated) Source HTTP tracking API 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 entièrement obsolète 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 une erreur.

Nous vous encourageons à commencer à utiliser le nouveau format de 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 vous référer à notre documentation pour plus d’informations sur l’utilisation du nouveau format.
{% endhint %}

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

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

L’HTTP Tracking API 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

### Headers

#### Authentification

Authentifiez-vous auprès de la Tracking API en envoyant le **Source Key** de votre projet avec une requête dans les headers, comme ceci : `Authorization: Bearer NJtcKaoCYu...mGZDxRgMBMUw==`

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

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

Pour envoyer des données à notre HTTP API, un header 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é à l’aide de l’interface de la plateforme ou de notre [config API](/fr/developers/config-api.md) (event inspector ou event delivery API). La seule exception est que si la requête est trop volumineuse ou si le JSON n’est pas valide, un code 400 sera renvoyé.

### 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 requests per second**, veuillez [contact us](mailto:support@commandersact.com) au préalable.

## Event API <a href="#track" id="track"></a>

Vous pouvez utiliser l’event API pour capturer les actions effectuées par vos utilisateurs. Chaque action donne lieu à ce que l’on appelle un « event », auquel sont associées des propriétés.

Vous devez suivre les activités qui indiquent les performances de votre app, telles que Signed Up, Item Purchased et Article Bookmarked. Pour commencer, nous recommandons de ne suivre que quelques événements clés. D’autres pourront facilement être ajoutés plus tard !

Exemple `event` call: <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"
 }
}
```

Trouvez des détails sur **les bonnes pratiques de nommage des events** ainsi que sur le **`event` method payload** dans notre [Spec](/fr/developers/tracking-and-integrations/tracking/about-events.md).

{% hint style="info" %}
Si vous souhaitez utiliser Http tracking API depuis votre application mobile plutôt que le SDK, consultez la [Mobile event specificity](/fr/developers/tracking-and-integrations/tracking/about-events/mobile-sdk-event-specificity.md)
{% endhint %}

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

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.