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

# Szybki start z REST API

> Utwórz token API i wykonaj pierwsze wywołanie publicznego API Zippendo z własnego systemu.

REST API pozwala Twoim własnym systemom współpracować z Zippendo bezpośrednio, dzięki czemu Twój sklep internetowy, ERP lub system magazynowy może tworzyć przesyłki, odczytywać zamówienia i pobierać etykiety bez otwierania aplikacji. Każdy publiczny endpoint jest wymieniony na karcie API reference, razem z playgroundem do wypróbowywania zapytań.

## 1. Utwórz token API

<Steps>
  <Step title="Otwórz Ustawienia API">
    W [app.zippendo.com](https://app.zippendo.com) otwórz menu organizacji na dole panelu bocznego, kliknij **Zarządzaj**, a potem **Ustawienia API**.
  </Step>

  <Step title="Utwórz token">
    Kliknij **Dodaj token API**, nadaj mu nazwę (na przykład `Production WMS`), zaznacz potrzebne **Uprawnienia** i kliknij **Utwórz token**. Skopiuj token od razu: jest pokazywany tylko raz.
  </Step>

  <Step title="Przechowuj go bezpiecznie">
    Tokeny API zaczynają się od `zipp_`. Traktuj je jak hasła: trzymaj je w zmiennych środowiskowych, nigdy w repozytorium kodu.
  </Step>
</Steps>

Uprawnienia, wygasanie, ograniczenie do marki i usuwanie tokenów opisano w [Ustawienia API](/docs/pl/settings/api-settings).

## 2. Znajdź ID swojej organizacji

Każdy endpoint przyjmuje ID Twojej organizacji (`orgId`) w ścieżce. Zapytaj Zippendo, do której organizacji należy Twój token:

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

Odpowiedź zawiera `orgId`, a także `scopes` i `expiresAt` tokena.

## 3. Wykonaj pierwsze zapytanie

Przesyłaj token jako dane uwierzytelniające Bearer w każdym zapytaniu:

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

Zastąp `{orgId}` ID z kroku 2. Token potrzebuje do tego wywołania uprawnienia `read:shipments`.

<Warning>
  Nigdy nie umieszczaj tokenów API w kodzie uruchamianym w przeglądarce ani w aplikacji mobilnej. Wywołuj Zippendo ze swojego backendu.
</Warning>

<Tip>
  Wolisz typowanego klienta? Bezpłatne **[SDK](/docs/pl/sdks/overview)** dla TypeScript, Python, PHP, Go i Ruby obejmują każdy endpoint, więc możesz pominąć surowe HTTP.
</Tip>

Każdy plan ma limit zapytań na minutę. Zobacz [Limity zapytań](/docs/api-reference/rate-limits).

## 4. Poznaj endpointy

Publiczne API obejmuje:

| Obszar | Typowe zastosowanie |
| - | - |
| Przesyłki | Tworzenie, wysyłanie, dzielenie i śledzenie przesyłek; pobieranie etykiet i dokumentów |
| Zamówienia | Tworzenie zamówień i odczyt zamówień zaimportowanych przez Twoje kanały sprzedaży |
| Kanały sprzedaży | Zarządzanie [własnymi kanałami](/docs/pl/order-channels/custom-channels) dla Twojego sklepu internetowego lub ERP |
| Przewoźnicy | Łączenie przewoźników, wyświetlanie ich produktów i wyszukiwanie punktów odbioru |
| Wycena wysyłki | Ceny z Twoich reguł wysyłki dla koszyka w kasie |
| Reguły wysyłki | Odczyt i zarządzanie regułami wysyłki |
| Webhooki | Powiadomienia o zmianach przesyłek, zamówień i śledzenia |
| Adresy | Zarządzanie adresami nadawcy, odbioru i zwrotu |

Otwórz [API reference](/docs/api-reference/overview), aby przeglądać ścieżki i treści zapytań oraz wypróbowywać zapytania w playgroundzie.

## Kolejne kroki

<CardGroup cols={2}>
  <Card title="Szybki start z webhookami" icon="webhook" href="/docs/pl/quickstarts/webhooks">
    Wysyłaj zdarzenia na swój serwer, gdy dane się zmieniają.
  </Card>

  <Card title="Wyceny wysyłki" icon="calculator" href="/docs/pl/quickstarts/shipping-quotes">
    Pokaż ceny wysyłki dla koszyka w kasie.
  </Card>

  <Card title="Serwer MCP" icon="bot" href="/docs/pl/mcp/overview">
    Pozwól, aby Claude, Cursor lub ChatGPT pracowały w Zippendo za Ciebie.
  </Card>

  <Card title="Własne kanały" icon="plug" href="/docs/pl/order-channels/custom-channels">
    Wysyłaj zamówienia z własnego sklepu internetowego lub ERP do Zippendo.
  </Card>
</CardGroup>


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