# Segment API

## Récupérer les ID des segments

Renvoie la liste des segments pour l'utilisateur

#### URL de la ressource <a href="#resource-url" id="resource-url"></a>

<https://api.commander1.com/api/dms/segmentation/segments>

#### Informations sur la ressource <a href="#resource-information" id="resource-information"></a>

| Formats de réponse         | javascript (JSONP)                                     |
| -------------------------- | ------------------------------------------------------ |
| Authentification requise ? | Non si tcid n'est pas défini, token si tcid est défini |

#### Paramètres

| NOM                | EXIGENCE       | EXEMPLES DE VALEURS              | DESCRIPTION                              |
| ------------------ | -------------- | -------------------------------- | ---------------------------------------- |
| site               | \d+            | 1234                             | ID du site à interroger pour les détails |
| tcid (facultatif)  | \d+            | 1234                             | ID du tcid (si cookie est désactivé)     |
| token (facultatif) | \[a-zA-Z0-9]\* | WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA | Jeton de sécurité (si tcid est défini)   |
| callback           | \w+            | do\_something                    | méthode de rappel javascript pour JSONP  |

#### Exemple de requête <a href="#example-request" id="example-request"></a>

`GET`

<https://api.commander1.com/api/dms/segmentation/segments?site=1234\\&callback=tC\\_funcEngage>

#### Exemple de résultat <a href="#example-result" id="example-result"></a>

```
/**/tC_funcEngage(["F92C4F26"]);
```

## Récupérer la liste des segments

Renvoie la liste des segments créés dans Engage UIX

#### URL de la ressource <a href="#resource-url" id="resource-url"></a>

<https://api.commander1.com/api/dms/segmentation/segments/list>

#### Informations sur la ressource <a href="#resource-information" id="resource-information"></a>

| Formats de réponse         | JSON        |
| -------------------------- | ----------- |
| Authentification requise ? | Oui (token) |

#### Paramètres

| NOM   | EXIGENCE       | EXEMPLES DE VALEURS              | DESCRIPTION                              |
| ----- | -------------- | -------------------------------- | ---------------------------------------- |
| site  | d+             | 1234                             | ID du site à interroger pour les détails |
| token | \[a-zA-Z0-9]\* | WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA | Jeton de sécurité                        |

#### Exemple de requête <a href="#example-request" id="example-request"></a>

`GET`

<https://api.commander1.com/api/dms/segmentation/segments/list?site=1234\\&token=WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA>

#### Exemple de résultat <a href="#example-result" id="example-result"></a>

```
[{"id":"BBFAC450","label":"prospect VIP"},{"id":"3DCC6A0A","label":"Nouveau client"}]
```
