# Fans

> Référence générée depuis le contrat OpenAPI : Fans.

URL : https://docs.fanconvert.ai/fr/api/reference/fans

{/* Généré par scripts/generer-reference.mjs depuis openapi/public-v1.json : ne pas modifier à la main. */}

## Les étiquettes de fans d'une créatrice [#les-étiquettes-de-fans-dune-créatrice]

`GET /public/v1/creators/{creator_id}/labels` · `listFanLabels`

### Paramètres [#paramètres]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Réponse 200 [#réponse-200]

**`Page_FanLabel_`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `items` | FanLabel[] | oui |  |
| `nextCursor` | string \| null | non | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`FanLabel`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `name` | string | oui |  |
| `color` | string | oui |  |

### Erreurs possibles [#erreurs-possibles]

`401` · `403` · `404` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/labels" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## La fiche d'un fan : étiquettes et note de l'équipe [#la-fiche-dun-fan--étiquettes-et-note-de-léquipe]

`GET /public/v1/creators/{creator_id}/fans/{conversation_id}` · `getFan`

### Paramètres [#paramètres-1]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Réponse 200 [#réponse-200-1]

**`FanCard`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | "mym" \| "telegram" | oui |  |
| `labels` | FanLabel[] | oui |  |
| `note` | TeamNote | oui |  |

**`FanLabel`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `name` | string | oui |  |
| `color` | string | oui |  |

**`TeamNote`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `text` | string \| null | oui |  |
| `revision` | integer | oui | À renvoyer en `expectedRevision` pour écrire. |
| `updatedAt` | string (date-time) \| null | oui |  |

### Erreurs possibles [#erreurs-possibles-1]

`401` · `403` · `404` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-1]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/fans/{conversation_id}" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Écrire la note de l'équipe sur un fan [#écrire-la-note-de-léquipe-sur-un-fan]

`PUT /public/v1/creators/{creator_id}/fans/{conversation_id}/note` · `putFanNote`

### Paramètres [#paramètres-2]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Corps de la requête [#corps-de-la-requête]

**`TeamNoteWrite`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `text` | string | oui | La note, 1 000 caractères au plus ; vide = retirée. |
| `expectedRevision` | integer | oui | La `revision` lue : une autre écriture entre-temps → 409. |

### Réponse 200 [#réponse-200-2]

**`FanCard`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | "mym" \| "telegram" | oui |  |
| `labels` | FanLabel[] | oui |  |
| `note` | TeamNote | oui |  |

**`FanLabel`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `name` | string | oui |  |
| `color` | string | oui |  |

**`TeamNote`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `text` | string \| null | oui |  |
| `revision` | integer | oui | À renvoyer en `expectedRevision` pour écrire. |
| `updatedAt` | string (date-time) \| null | oui |  |

### Erreurs possibles [#erreurs-possibles-2]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-2]

```bash
curl -X PUT "https://app.fanconvert.ai/public/v1/creators/{creator_id}/fans/{conversation_id}/note" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ … }'
```

## Poser une étiquette sur un fan (sans effet si elle y est déjà) [#poser-une-étiquette-sur-un-fan-sans-effet-si-elle-y-est-déjà]

`PUT /public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}` · `addFanLabel`

### Paramètres [#paramètres-3]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `label_id` | chemin | string | oui | Identifiant de l'étiquette. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Réponse 200 [#réponse-200-3]

**`FanCard`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | "mym" \| "telegram" | oui |  |
| `labels` | FanLabel[] | oui |  |
| `note` | TeamNote | oui |  |

**`FanLabel`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `name` | string | oui |  |
| `color` | string | oui |  |

**`TeamNote`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `text` | string \| null | oui |  |
| `revision` | integer | oui | À renvoyer en `expectedRevision` pour écrire. |
| `updatedAt` | string (date-time) \| null | oui |  |

### Erreurs possibles [#erreurs-possibles-3]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-3]

```bash
curl -X PUT "https://app.fanconvert.ai/public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Retirer une étiquette d'un fan [#retirer-une-étiquette-dun-fan]

`DELETE /public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}` · `removeFanLabel`

### Paramètres [#paramètres-4]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `label_id` | chemin | string | oui | Identifiant de l'étiquette. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Réponse 200 [#réponse-200-4]

**`FanCard`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | "mym" \| "telegram" | oui |  |
| `labels` | FanLabel[] | oui |  |
| `note` | TeamNote | oui |  |

**`FanLabel`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `name` | string | oui |  |
| `color` | string | oui |  |

**`TeamNote`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `text` | string \| null | oui |  |
| `revision` | integer | oui | À renvoyer en `expectedRevision` pour écrire. |
| `updatedAt` | string (date-time) \| null | oui |  |

### Erreurs possibles [#erreurs-possibles-4]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-4]

```bash
curl -X DELETE "https://app.fanconvert.ai/public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```