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

# SDK's

> Gratis Zippendo-clientbibliotheken voor TypeScript, Python, PHP, Go en Ruby.

Met de SDK's kan je ontwikkelaar je webshop, ERP of magazijnsysteem met een paar regels code aan Zippendo koppelen in plaats van ruwe HTTP-aanroepen te schrijven. Het zijn gratis clientbibliotheken voor TypeScript, Python, PHP, Go en Ruby en ze dekken elk endpoint in de API-referentie.

<CardGroup cols={2}>
  <Card title="TypeScript / JavaScript" icon="package" href="https://www.npmjs.com/package/@zippendo/sdk">
    npm: `@zippendo/sdk`
  </Card>

  <Card title="Python" icon="package" href="https://pypi.org/project/zippendo">
    PyPI: `zippendo`
  </Card>

  <Card title="PHP" icon="package" href="https://packagist.org/packages/zippendo/zippendo-php">
    Packagist: `zippendo/zippendo-php`
  </Card>

  <Card title="Go" icon="package" href="https://github.com/zippendo/zippendo-go">
    `github.com/zippendo/zippendo-go`
  </Card>

  <Card title="Ruby" icon="package" href="https://rubygems.org/gems/zippendo">
    RubyGems: `zippendo`
  </Card>
</CardGroup>

## Installeren

<CodeGroup>
  ```bash npm theme={null}
  npm install @zippendo/sdk
  ```

  ```bash pip theme={null}
  pip install zippendo
  ```

  ```bash composer theme={null}
  composer require zippendo/zippendo-php
  ```

  ```bash go theme={null}
  go get github.com/zippendo/zippendo-go
  ```

  ```bash gem theme={null}
  gem install zippendo
  ```
</CodeGroup>

## Authenticeren en je eerste aanroep doen

Maak een API-token aan onder **API-instellingen** (open het organisatiemenu onderaan de zijbalk en kies **Beheren**). Het begint met `zipp_` en wordt verstuurd als Bearer-token. De basis-URL is standaard `https://api.zippendo.com`.

<CodeGroup>
  ```ts TypeScript theme={null}
  import { Configuration, ShipmentsApi } from "@zippendo/sdk"

  const shipments = new ShipmentsApi(
    new Configuration({ accessToken: process.env.ZIPPENDO_API_TOKEN })
  )

  const page = await shipments.listShipments({ orgId: "org_8f3kd92ld0", page: 1, limit: 50 })
  console.log(page.data)
  ```

  ```python Python theme={null}
  import os
  import zippendo

  config = zippendo.Configuration(access_token=os.environ["ZIPPENDO_API_TOKEN"])
  with zippendo.ApiClient(config) as client:
      page = zippendo.ShipmentsApi(client).list_shipments("org_8f3kd92ld0", page=1, limit=50)
      print(page.data)
  ```

  ```php PHP theme={null}
  <?php
  require_once __DIR__ . "/vendor/autoload.php";

  $config = Zippendo\Sdk\Configuration::getDefaultConfiguration()
      ->setAccessToken(getenv("ZIPPENDO_API_TOKEN"));

  $shipments = new Zippendo\Sdk\Api\ShipmentsApi(new GuzzleHttp\Client(), $config);
  $page = $shipments->listShipments("org_8f3kd92ld0", 1, 50);
  ```

  ```go Go theme={null}
  client := zippendo.NewAPIClient(zippendo.NewConfiguration())
  ctx := context.WithValue(context.Background(), zippendo.ContextAccessToken, os.Getenv("ZIPPENDO_API_TOKEN"))

  page, _, err := client.ShipmentsAPI.ListShipments(ctx, "org_8f3kd92ld0").Page(1).Limit(50).Execute()
  ```

  ```ruby Ruby theme={null}
  require "zippendo"

  Zippendo.configure { |c| c.access_token = ENV["ZIPPENDO_API_TOKEN"] }
  page = Zippendo::ShipmentsApi.new.list_shipments("org_8f3kd92ld0", page: 1, limit: 50)
  ```
</CodeGroup>

<Info>
  Elke aanroep heeft de ID van je organisatie (`orgId`) nodig. Een API-token hoort bij één organisatie en aanroepen voor een andere organisatie worden geweigerd. Om de ID op te zoeken roep je `verifyApiToken` aan op `TokensApi` met je token: het antwoord bevat `orgId`. Zie de [REST API-quickstart](/docs/nl/quickstarts/rest-api).
</Info>

## Resources

Elke SDK heeft een client per resource, zoals `ShipmentsApi`, `OrdersApi`, `CarriersApi`, `AddressesApi`, `RulesApi`, `WebhooksApi` en `TokensApi`, overeenkomstig de groepen in de API-referentie. Paginering (`page`/`limit`), request bodies en foutafhandeling (fouten bevatten `{ code, error, message }`) worden beschreven in de README van elke SDK.

## Referentie

Blader door elk endpoint en probeer verzoeken uit in de playground in de [API-referentie](/docs/api-reference/overview).

<Tip>
  Bouw je met AI-agents? De [**MCP-server**](/docs/nl/mcp/overview) geeft Claude, Cursor, ChatGPT en andere AI-tools na inloggen via de browser dezelfde acties, zonder dat je een SDK hoeft te installeren.
</Tip>


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