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

> Gratis klientbiblioteker fra Zippendo for TypeScript, Python, PHP, Go og Ruby.

SDK-ene lar utvikleren din koble nettbutikken, ERP-systemet eller lagersystemet ditt til Zippendo med noen få linjer kode i stedet for å skrive HTTP-kall for hånd. De er gratis klientbiblioteker for TypeScript, Python, PHP, Go og Ruby, og de dekker alle endepunkter i API-referansen.

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

## Installer

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

## Logg inn og gjør det første kallet

Opprett et API-token under **API-innstillinger** (åpne organisasjonsmenyen nederst i sidefeltet, og velg **Administrer**). Det starter med `zipp_` og sendes som et Bearer-token. Basis-URL-en er som standard `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>
  Hvert kall krever organisasjons-ID-en din (`orgId`). Et API-token tilhører én organisasjon, og kall for andre organisasjoner blir avvist. For å finne ID-en kaller du `verifyApiToken` på `TokensApi` med tokenet ditt: svaret inneholder `orgId`. Se [hurtigstart for REST API](/docs/no/quickstarts/rest-api).
</Info>

## Ressurser

Hver SDK har en klient per ressurs, for eksempel `ShipmentsApi`, `OrdersApi`, `CarriersApi`, `AddressesApi`, `RulesApi`, `WebhooksApi` og `TokensApi`, som tilsvarer gruppene i API-referansen. Paginering (`page`/`limit`), forespørselsinnhold og feilhåndtering (feil har `{ code, error, message }`) er beskrevet i README-filen til hver SDK.

## Referanse

Bla gjennom alle endepunkter, og prøv forespørsler i lekeplassen, i [API-referansen](/docs/api-reference/overview).

<Tip>
  Bygger du med AI-agenter? [**MCP-serveren**](/docs/no/mcp/overview) gir Claude, Cursor, ChatGPT og andre AI-verktøy de samme handlingene etter innlogging i nettleseren, uten at du trenger å installere noen SDK.
</Tip>


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