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

> Kostnadsfria Zippendo-klientbibliotek för TypeScript, Python, PHP, Go och Ruby.

Med SDK:erna kan din utvecklare ansluta din webbutik, ditt ERP- eller lagersystem till Zippendo med några rader kod i stället för att skriva råa HTTP-anrop. De är kostnadsfria klientbibliotek för TypeScript, Python, PHP, Go och Ruby, och de täcker alla endpoints i API-referensen.

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

## Installera

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

## Autentisera och gör ditt första anrop

Skapa en API-token under **API-inställningar** (öppna organisationsmenyn längst ned i sidofältet och sedan **Hantera**). Den börjar med `zipp_` och skickas som en Bearer-token. Bas-URL:en är 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>
  Varje anrop tar ditt organisations-ID (`orgId`). En API-token hör till en organisation, och anrop för andra organisationer nekas. Om du vill slå upp ID:t anropar du `verifyApiToken` på `TokensApi` med din token: svaret innehåller `orgId`. Se [snabbstarten för REST API](/docs/sv/quickstarts/rest-api).
</Info>

## Resurser

Varje SDK har en klient per resurs, till exempel `ShipmentsApi`, `OrdersApi`, `CarriersApi`, `AddressesApi`, `RulesApi`, `WebhooksApi` och `TokensApi`, som motsvarar grupperna i API-referensen. Paginering (`page`/`limit`), anropskroppar och felhantering (fel innehåller `{ code, error, message }`) beskrivs i varje SDK:s README.

## Referens

Bläddra bland alla endpoints och testa anrop i lekplatsen i [API-referensen](/docs/api-reference/overview).

<Tip>
  Bygger du med AI-agenter? [**MCP-servern**](/docs/sv/mcp/overview) ger Claude, Cursor, ChatGPT och andra AI-verktyg samma åtgärder efter en inloggning i webbläsaren, utan att du behöver installera någon SDK.
</Tip>


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