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

# Quickstart voor de REST API

> Maak een API-token aan en doe je eerste aanroep naar de openbare Zippendo API vanuit je eigen systeem.

Met de REST API kunnen je eigen systemen rechtstreeks met Zippendo werken, zodat je webshop, ERP of magazijnsysteem zendingen kan aanmaken, bestellingen kan lezen en verzendlabels kan ophalen zonder dat iemand de app opent. Elk openbaar endpoint staat in het tabblad API-referentie, met een playground om verzoeken uit te proberen.

## 1. Maak een API-token aan

<Steps>
  <Step title="Open API-instellingen">
    Open in [app.zippendo.com](https://app.zippendo.com) het organisatiemenu onderaan de zijbalk, klik op **Beheren** en dan op **API-instellingen**.
  </Step>

  <Step title="Maak een token aan">
    Klik op **API-token toevoegen**, geef het een naam (bijvoorbeeld `Production WMS`), vink de **Rechten** aan die het nodig heeft en klik op **Token aanmaken**. Kopieer het token meteen: het wordt maar één keer getoond.
  </Step>

  <Step title="Bewaar het veilig">
    API-tokens beginnen met `zipp_`. Behandel ze als wachtwoorden: bewaar ze in omgevingsvariabelen, nooit in versiebeheer.
  </Step>
</Steps>

Zie [API-instellingen](/docs/nl/settings/api-settings) voor rechten, vervaldatum, beperking tot een merk en het verwijderen van tokens.

## 2. Zoek je organisatie-ID

Elk endpoint verwacht je organisatie-ID (`orgId`) in het pad. Vraag Zippendo bij welke organisatie je token hoort:

```bash theme={null}
curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'
```

Het antwoord bevat `orgId`, samen met de `scopes` en `expiresAt` van het token.

## 3. Doe je eerste verzoek

Stuur het token als Bearer-inloggegevens mee bij elk verzoek:

```bash theme={null}
curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"
```

Vervang `{orgId}` door het ID uit stap 2. Het token heeft het recht `read:shipments` nodig voor deze aanroep.

<Warning>
  Zet API-tokens nooit in code die in een browser of mobiele app draait. Roep Zippendo aan vanuit je backend.
</Warning>

<Tip>
  Liever een getypeerde client? Gratis **[SDK's](/docs/nl/sdks/overview)** voor TypeScript, Python, PHP, Go en Ruby dekken elk endpoint, zodat je de ruwe HTTP kunt overslaan.
</Tip>

Elk abonnement heeft een verzoekbudget per minuut. Zie [Limieten](/docs/api-reference/rate-limits).

## 4. Verken de endpoints

De openbare API omvat:

| Gebied | Typisch gebruik |
| - | - |
| Zendingen | Zendingen aanmaken, verzenden, splitsen en volgen; verzendlabels en documenten ophalen |
| Bestellingen | Bestellingen aanmaken en de bestellingen lezen die je verkoopkanalen hebben geïmporteerd |
| Verkoopkanalen | [Eigen kanalen](/docs/nl/order-channels/custom-channels) beheren voor je eigen webshop of ERP |
| Vervoerders | Vervoerders koppelen, hun producten tonen en afhaalpunten opzoeken |
| Verzendofferte | Prijzen uit je verzendregels voor een winkelwagen bij de checkout |
| Verzendregels | Verzendregels lezen en beheren |
| Webhooks | Een melding krijgen wanneer zendingen, bestellingen en track & trace veranderen |
| Adressen | Afzender-, ophaal- en retouradressen beheren |

Open de [API-referentie](/docs/api-reference/overview) om paden en request bodies te bekijken en om verzoeken in de playground uit te proberen.

## Volgende stappen

<CardGroup cols={2}>
  <Card title="Webhooks-quickstart" icon="webhook" href="/docs/nl/quickstarts/webhooks">
    Stuur gebeurtenissen naar je server wanneer gegevens veranderen.
  </Card>

  <Card title="Verzendoffertes" icon="calculator" href="/docs/nl/quickstarts/shipping-quotes">
    Toon verzendprijzen voor een winkelwagen bij de checkout.
  </Card>

  <Card title="MCP-server" icon="bot" href="/docs/nl/mcp/overview">
    Laat Claude, Cursor of ChatGPT voor je in Zippendo werken.
  </Card>

  <Card title="Eigen kanalen" icon="plug" href="/docs/nl/order-channels/custom-channels">
    Stuur bestellingen van je eigen webshop of ERP naar Zippendo.
  </Card>
</CardGroup>


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