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

# Lokaal testen

> Download de Codaclean-collectie en roep binnen enkele minuten de API aan vanuit Bruno of Postman.

[Bruno](https://www.usebruno.com) is een gratis opensource-API-client die op uw computer draait.

Met de Codaclean-collectie probeert u elk endpoint uit zonder één regel code te schrijven. De collectie gebruikt het Postman-formaat en werkt dus ook in Postman.

<Steps>
  <Step title="Bruno installeren">
    Download Bruno op [usebruno.com](https://www.usebruno.com) en installeer het.
  </Step>

  <Step title="De collectie downloaden">
    <a href="/downloads/codaclean-api.postman_collection.txt" download="codaclean-api.postman_collection.json">Download de Codaclean-collectie</a> (JSON-bestand, Postman-formaat v2.1).
  </Step>

  <Step title="De collectie in Bruno importeren">
    Importeer in Bruno een collectie en kies het formaat **Postman collection**.

    Selecteer het gedownloade bestand en daarna de map waarin Bruno de collectie moet bewaren.
  </Step>

  <Step title="De variabelen invullen">
    Maak in Bruno een omgeving aan voor de collectie, selecteer ze en voeg er deze variabelen aan toe:

    | Variabele  | Waarde                                                                                                       |
    | ---------- | ------------------------------------------------------------------------------------------------------------ |
    | `baseUrl`  | Standaard staging: `https://api.test.codaclean.io/v1`. Gebruik `https://api.codaclean.io/v1` voor productie. |
    | `apiKey`   | Uw API-sleutel.                                                                                              |
    | `username` | De Codaclean-login van de gebruiker.                                                                         |
    | `password` | Het wachtwoord van de gebruiker, **in platte tekst**: de collectie codeert het voor u in Base64.             |
  </Step>

  <Step title="Een token ophalen">
    Voer **Authentication › Get a token** uit.

    De collectie bewaart de ID-token en de refreshtoken. Alle andere aanvragen gebruiken ze automatisch.

    De ID-token is 1 uur geldig. Voer daarna **Refresh the token** uit, of voer **Get a token** opnieuw uit.
  </Step>

  <Step title="De API aanroepen">
    Begin met **Utilities › Hello world** om te controleren of alles werkt.

    Aanvragen voor een bepaalde klant, een bepaald mandaat of een bepaald bestand gebruiken een variabele in hun URL: `customerId`, `iban`, `payrollProviderCode`, `mandateId` of `fileId`. Vul die in met een waarde uit het antwoord van een lijstaanvraag.
  </Step>
</Steps>

<Warning>
  De variabelen van de collectie bevatten uw API-sleutel en het wachtwoord van de gebruiker. Bewaar de collectie op uw computer: deel ze niet en zet ze niet in een coderepository.
</Warning>

## Postman gebruiken

Importeer hetzelfde bestand in Postman. De variabelen staan op het tabblad **Variables** van de collectie, en de aanvragen werken op dezelfde manier.

**Zie ook:** [Authenticatie](/nl/api/authentication) · [Omgevingen](/nl/api/environments)