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

# Pakiety SDK

> Bezpłatne biblioteki klienckie Zippendo dla TypeScript, Python, PHP, Go i Ruby.

Pakiety SDK pozwalają programiście połączyć Twój sklep internetowy, system ERP lub magazynowy z Zippendo za pomocą kilku linii kodu, zamiast pisać surowe wywołania HTTP. To bezpłatne biblioteki klienckie dla TypeScript, Python, PHP, Go i Ruby, które obejmują każdy endpoint z dokumentacji API.

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

## Instalacja

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

## Uwierzytelnianie i pierwsze wywołanie

Utwórz token API w **Ustawieniach API** (otwórz menu organizacji na dole paska bocznego, a potem **Zarządzaj**). Zaczyna się od `zipp_` i jest wysyłany jako token Bearer. Bazowy adres URL to domyślnie `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>
  Każde wywołanie wymaga ID Twojej organizacji (`orgId`). Token API należy do jednej organizacji, a wywołania dla innej organizacji są odrzucane. Aby sprawdzić ID, wywołaj `verifyApiToken` w `TokensApi` ze swoim tokenem: odpowiedź zawiera `orgId`. Zobacz [Szybki start z REST API](/docs/pl/quickstarts/rest-api).
</Info>

## Zasoby

Każdy SDK ma klienta dla każdego zasobu, takiego jak `ShipmentsApi`, `OrdersApi`, `CarriersApi`, `AddressesApi`, `RulesApi`, `WebhooksApi` i `TokensApi`, zgodnie z grupami w dokumentacji API. Paginację (`page`/`limit`), treści żądań i obsługę błędów (błędy zawierają `{ code, error, message }`) opisano w README każdego SDK.

## Dokumentacja

Przeglądaj każdy endpoint i wypróbowuj żądania w piaskownicy w [dokumentacji API](/docs/api-reference/overview).

<Tip>
  Budujesz z agentami AI? [**Serwer MCP**](/docs/pl/mcp/overview) daje Claude, Cursor, ChatGPT i innym narzędziom AI te same akcje po zalogowaniu w przeglądarce, bez instalowania SDK.
</Tip>


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