> ## 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.

# Démarrage rapide

> Obtenez vos identifiants et un ID token, puis faites votre premier appel à l'API Codaclean.

Ce guide vous accompagne pas à pas, en partant de zéro, jusqu'à votre premier appel réussi.

Il vous faut une clé API délivrée par Codaclean et un compte utilisateur Codaclean.

C'est la fiduciaire qui crée et gère les comptes utilisateurs, dans [MyCodaclean](https://app.codaclean.io).

**Voir aussi :** [Authentification](/fr/api/authentication#comptes-utilisateurs-et-portée-du-token)

<Steps>
  <Step title="Obtenez une clé API">
    Codaclean délivre une clé API par logiciel partenaire.

    Cette clé identifie votre logiciel, et non une fiduciaire en particulier : la même clé vaut pour toutes les fiduciaires qui utilisent votre logiciel.

    <Card title="Demander un accès à l'API" icon="key" href="https://codaclean.be/fr-be/contact" horizontal>
      Contactez Codaclean pour obtenir une clé API.
    </Card>
  </Step>

  <Step title="Obtenez un ID token">
    Appelez [`POST /token`](/fr/api/endpoints/get-token) avec le `username` Codaclean de l'utilisateur et son `password` **encodé en Base64**. Transmettez votre clé API dans l'en-tête `x-api-key`.

    La réponse contient un `idToken` et un `refreshToken`.

    **Voir aussi :** [Authentification](/fr/api/authentication)
  </Step>

  <Step title="Faites votre premier appel">
    Appelez [`GET /hello`](/fr/api/endpoints/hello) avec ces deux en-têtes :

    | En-tête         | Valeur             |
    | --------------- | ------------------ |
    | `x-api-key`     | Votre clé API      |
    | `Authorization` | `Bearer <idToken>` |

    Une réponse `200` confirme que vos deux identifiants sont acceptés.
  </Step>

  <Step title="Choisissez votre cas d'usage">
    <CardGroup cols={2}>
      <Card title="Télécharger les fichiers CODA" icon="building-columns" href="/fr/api/guides/sync-coda-files">
        Listez les nouveaux extraits de compte, téléchargez-les, puis confirmez leur téléchargement.
      </Card>

      <Card title="Télécharger les fichiers CODB" icon="users" href="/fr/api/guides/sync-codb-files">
        Le même processus, pour les fichiers salariaux.
      </Card>

      <Card title="Ajouter un client" icon="building" href="/fr/api/guides/onboard-customer">
        Créez un client et demandez ses mandats.
      </Card>

      <Card title="Envoyer des fichiers" icon="upload" href="/fr/api/guides/upload-files">
        Transmettez des fichiers CODA ou CODB à Codaclean.
      </Card>
    </CardGroup>
  </Step>
</Steps>

## URL de base

| Environnement | URL de base                        |
| ------------- | ---------------------------------- |
| Production    | `https://api.codaclean.io/v1`      |
| Staging       | `https://api.test.codaclean.io/v1` |

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