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

# Tester en local

> Téléchargez la collection Codaclean et appelez l'API depuis Bruno ou Postman en quelques minutes.

[Bruno](https://www.usebruno.com) est un client d'API gratuit et open source qui s'exécute sur votre ordinateur.

La collection Codaclean vous permet d'essayer chaque endpoint sans écrire la moindre ligne de code. Elle utilise le format Postman et fonctionne donc aussi dans Postman.

<Steps>
  <Step title="Installez Bruno">
    Téléchargez Bruno sur [usebruno.com](https://www.usebruno.com) et installez-le.
  </Step>

  <Step title="Téléchargez la collection">
    <a href="/downloads/codaclean-api.postman_collection.txt" download="codaclean-api.postman_collection.json">Télécharger la collection Codaclean</a> (fichier JSON, format Postman v2.1).
  </Step>

  <Step title="Importez-la dans Bruno">
    Dans Bruno, importez une collection et choisissez le format **Postman collection**.

    Sélectionnez le fichier téléchargé, puis le dossier dans lequel Bruno doit enregistrer la collection.
  </Step>

  <Step title="Renseignez les variables">
    Dans Bruno, créez un environnement pour la collection, sélectionnez-le et ajoutez-y ces variables :

    | Variable   | Valeur                                                                                                                   |
    | ---------- | ------------------------------------------------------------------------------------------------------------------------ |
    | `baseUrl`  | Par défaut, le staging : `https://api.test.codaclean.io/v1`. Pour la production, utilisez `https://api.codaclean.io/v1`. |
    | `apiKey`   | Votre clé API.                                                                                                           |
    | `username` | L'identifiant Codaclean de l'utilisateur.                                                                                |
    | `password` | Le mot de passe de l'utilisateur, **en clair** : la collection l'encode en Base64 à votre place.                         |
  </Step>

  <Step title="Obtenez un token">
    Lancez **Authentication › Get a token**.

    La collection enregistre l'ID token et le refresh token. Toutes les autres requêtes les utilisent automatiquement.

    L'ID token est valable 1 heure. Passé ce délai, lancez **Refresh the token** ou relancez **Get a token**.
  </Step>

  <Step title="Appelez l'API">
    Commencez par **Utilities › Hello world** pour vérifier que tout fonctionne.

    Les requêtes qui portent sur un client, un mandat ou un fichier précis utilisent une variable dans leur URL : `customerId`, `iban`, `payrollProviderCode`, `mandateId` ou `fileId`. Renseignez-la avec une valeur tirée de la réponse d'un endpoint de liste.
  </Step>
</Steps>

<Warning>
  Les variables de la collection contiennent votre clé API et le mot de passe de l'utilisateur. Gardez la collection sur votre ordinateur : ne la partagez pas et ne l'ajoutez pas à un dépôt de code.
</Warning>

## Utiliser Postman

Dans Postman, importez le même fichier. Les variables se trouvent dans l'onglet **Variables** de la collection et les requêtes fonctionnent de la même manière.

**Voir aussi :** [Authentification](/fr/api/authentication) · [Environnements](/fr/api/environments)