> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usereplier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser l’API Replier

> Créez une clé API dans Gérer le compte, appelez l’API REST de Replier depuis votre propre code et gérez les erreurs, les nouvelles tentatives et les limites de requêtes.

L’API Replier permet à votre propre code ou à un outil d’automatisation de faire ce que vous faites dans Replier : lister les espaces de travail, comptes et publications, créer et modifier des automatisations, lire les résultats et les contacts, et envoyer des réponses de rattrapage ou d’automatisations ponctuelles. Pour utiliser Replier depuis ChatGPT, Claude ou un autre outil d’IA, utilisez plutôt les [connexions IA](https://docs.usereplier.com/fr/guides/ai-connections.md).

La [référence de l’API](https://docs.usereplier.com/api-reference/workspaces/list-workspaces.md) (en anglais) décrit chaque endpoint avec ses paramètres et ses réponses.

## Créer une clé API

1. Dans Replier, ouvrez le menu de votre compte et choisissez **Gérer le compte → Intégrations**.
2. Sous **Clés API**, sélectionnez **Créer une clé API**.
3. Saisissez un nom que vous reconnaîtrez, choisissez son accès et sélectionnez **Créer la clé**.
4. Copiez la clé. Replier ne l’affiche qu’une fois.

Toute personne qui détient la clé peut utiliser Replier en votre nom : gardez-la hors du code que vous partagez et hors du navigateur. Si elle fuite, supprimez-la et créez-en une autre.

Une clé qui peut seulement consulter vos données est refusée quand elle tente de modifier quelque chose. Une clé qui peut aussi modifier peut créer, modifier, activer ou désactiver et supprimer des automatisations, enregistrer vos textes par défaut, réordonner la file de la prochaine publication, importer des photos de réponse et envoyer les réponses de rattrapage et d’automatisations ponctuelles. Dans les deux cas, la clé agit avec votre rôle dans chaque espace de travail : elle ne peut pas faire plus que vous.

## Envoyer une requête

Envoyez la clé comme bearer token à `https://api.usereplier.com/v1` :

```bash theme={null}
curl https://api.usereplier.com/v1/workspaces \
  -H "Authorization: Bearer $REPLIER_API_KEY"
```

Les autres requêtes se font dans un espace de travail. Utilisez un `id` de cette liste :

```bash theme={null}
curl https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/accounts \
  -H "Authorization: Bearer $REPLIER_API_KEY"
```

Les requêtes qui modifient quelque chose envoient du JSON :

```bash theme={null}
curl -X PATCH https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/automations/$AUTOMATION_ID \
  -H "Authorization: Bearer $REPLIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
```

Les automatisations créées ou modifiées par l’API ont les mêmes limites que dans Replier : jusqu’à 24 cibles, trois boutons, une photo facultative et des parcours de messages dans les espaces de travail Studio.

## Erreurs

Une requête refusée répond avec un statut HTTP et un corps comme celui-ci :

```json theme={null}
{
  "error": {
    "code": "AUTOMATION_NOT_FOUND",
    "message": "Automation not found in this workspace."
  }
}
```

`code` ne change pas ; `message` est une explication en anglais dont la formulation peut changer. Certaines erreurs ajoutent d’autres champs, comme l’automatisation qui utilise déjà la publication choisie.

| Statut | Signification |
| - | - |
| 400 | La requête n’est pas valide. Pour `INVALID_REQUEST`, le message nomme le champ. |
| 401 | `INVALID_API_KEY` : la clé manque, est incorrecte, suspendue ou supprimée. |
| 403 | La clé ou votre rôle ne le permet pas, par exemple `WRITE_ACCESS_REQUIRED` pour une clé qui peut seulement consulter. |
| 404 | L’espace de travail, le compte ou l’automatisation n’existe pas ou vous n’y avez pas accès, par exemple `WORKSPACE_NOT_FOUND`. |
| 409 | La requête entre en conflit avec l’état actuel, par exemple `VERSION_CONFLICT` si l’automatisation a changé depuis votre lecture. |
| 429 | `RATE_LIMITED` : plus de 300 requêtes en une minute avec cette clé. Patientez le nombre de secondes indiqué par l’en-tête `Retry-After` puis réessayez. |
| 500 | Replier a rencontré une erreur. Réessayez avec la même `Idempotency-Key`. |

## Réessayer sans risque

Les requêtes qui modifient quelque chose acceptent l’en-tête `Idempotency-Key`. Envoyez une nouvelle valeur aléatoire, par exemple un UUID, pour chaque opération, et la même valeur quand vous la réessayez. Une nouvelle tentative avec la même valeur renvoie le premier résultat au lieu de créer une seconde automatisation ou d’envoyer les réponses deux fois. L’envoi des réponses de rattrapage, aux anciens commentaires ou d’automatisations ponctuelles, ainsi que la création d’une automatisation ponctuelle, exigent l’en-tête ; sans lui, la requête est refusée avec `IDEMPOTENCY_KEY_REQUIRED`.

```bash theme={null}
curl -X POST https://api.usereplier.com/v1/workspaces/$WORKSPACE_ID/catch-up \
  -H "Authorization: Bearer $REPLIER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f9c1d2e-8a7b-4c3d-9e1f-2a6b5c8d7e0f" \
  -d @items.json
```

Pour ne pas écraser la modification de quelqu’un d’autre, envoyez `expected_version` avec la version que vous avez lue. Si l’automatisation a changé depuis, la requête est refusée avec `VERSION_CONFLICT`. Il est obligatoire pour supprimer une automatisation.

## Évolutions de l’API

Dans `/v1`, Replier ne fait qu’ajouter : de nouveaux endpoints, de nouveaux paramètres facultatifs, de nouveaux champs de réponse et de nouvelles valeurs dans les champs d’état ou de motif. Ignorez les champs et valeurs que vous ne connaissez pas. Un changement qui casserait le code existant arrivera en `/v2`.

## Suspendre ou supprimer une clé

Dans **Gérer le compte → Intégrations**, chaque clé affiche son accès et sa dernière utilisation. Choisissez **Suspendre l’accès** pour refuser ses requêtes jusqu’à ce que vous choisissiez **Réactiver l’accès**. Choisissez **Supprimer la clé** pour la retirer définitivement ; le code qui l’utilise perd l’accès immédiatement. Les automatisations qu’elle a créées continuent de fonctionner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.