# Wprowadzenie

Witamy w **dokumentacji dla programistów Apaczka**. Apaczka API v2 pozwala
wyceniać, tworzyć i zarządzać przesyłkami kurierskimi ponad 20 przewoźników
przez jedną integrację.

## Jak działa API

API v2 to API w stylu RPC: każde wywołanie to HTTP `POST` z kopertą
form-encoded podpisaną **HMAC-SHA256**, a każda odpowiedź wraca jako
HTTP `200` — rzeczywisty wynik znajduje się w ciele odpowiedzi.
Zacznij od [podpisywania żądań](/pl/legacy/hmac-signing) i
[semantyki błędów](/pl/legacy/error-semantics), a następnie zapoznaj się z
pełną [referencją API v2](/pl/reference/v2-legacy).

## Pierwsze kroki

1. Uzyskaj dane dostępowe API w [panelu Apaczka](https://panel.apaczka.pl)
   w sekcji **Ustawienia → API**.
2. Przejdź [szybki start](/pl/quick-start).
3. Zapoznaj się z [przewodnikami integracyjnymi](/pl/guides/authentication).

## SDK — zalecany sposób integracji

Oficjalne **AlsendoOne SDK** dla PHP
([`alsendo/alsendo-one-sdk`](https://packagist.org/packages/alsendo/alsendo-one-sdk),
[źródła na GitHubie](https://github.com/Alsendo/AlsendoOneSDK)) to
preferowany sposób integracji: obsługuje podpisywanie żądań i mapowanie
błędów, a każdą metodę API udostępnia przez typowane obiekty. Zacznij od
[przewodnika SDK PHP](/pl/sdk). Integracje w innych językach wywołują API
bezpośrednio — zobacz
[podpisywanie żądań (HMAC)](/pl/legacy/hmac-signing).