# Historia zmian

Co zmieniło się w tej dokumentacji, od najnowszych zmian. Zajrzyj tu, gdy
wracasz do dokumentacji — dowiesz się, które strony warto przeczytać
ponownie.

Wpisy oznaczone **API Reference** zmieniają to, co opisuje
[API v2 Reference](/pl/reference/v2-legacy). Zwykle chodzi o pole lub
zachowanie, które już działało w API, a brakowało go w dokumentacji — nie
o zmianę samego API. Jeśli zmiana dotyczy API, wpis mówi to wprost.

## 2026-10-08

- **Portal:** dokumentacja przeniosła się pod adres
  [api-docs.apaczka.pl](https://api-docs.apaczka.pl). Poprzedni adres,
  `api-v2-docs.apaczka.pl`, przekierowuje na nowy — zaktualizuj zakładki
  i linki wewnętrzne.

## 2026-10-05

- **API Reference:** opisane pole zamówienia `push_tracking_url` (adres
  webhooka dla konkretnego zamówienia) oraz payload webhooka
  `PushTrackingNotification`.
- **API Reference:** poprawione przykłady odpowiedzi `tracking` —
  realistyczne statusy, znaczniki czasu w ISO 8601 (UTC).
- **Przewodniki:** przewodnik [Śledzenie przesyłek](/pl/guides/tracking)
  opisuje teraz push tracking od początku do końca: payload webhooka, 18
  statusów webhooka i ich mapowanie na statusy z odpytywania, weryfikację
  podpisu bez SDK, domyślny adres webhooka na poziomie aplikacji oraz
  ponawianie doręczenia, dopóki Twój endpoint nie odpowie HTTP `200`.

## 2026-09-18

- **Nowa sekcja:** [Migracja z Ecolet](/pl/migration/ecolet-overview) —
  dla integratorów przechodzących z API Ecolet:
  [mapowanie endpointów](/pl/migration/ecolet-endpoint-map) oraz
  [braki i obejścia](/pl/migration/ecolet-gaps) z checklistą migracji.
- **Przewodniki:** przykład porównania usług w przewodniku
  [Wybór usługi z oferty](/pl/guides/choosing-a-service) uwzględnia teraz
  flagę transportu `door_to_door`.

## 2026-09-07

- **Nowy przewodnik:** [Wybór usługi z oferty](/pl/guides/choosing-a-service)
  — wycena przesyłki bez `service_id`, łączenie `price_table` z flagami
  `service_structure` i uzupełnienie payloadu dla wybranej usługi.
  Przykłady kodu zweryfikowane z AlsendoOneSDK 1.1.0.
- **API Reference:** produkcyjny adres bazowy to wszędzie
  `https://www.apaczka.pl/api/v2/` — w API Reference, w przewodniku
  o podpisywaniu HMAC i w przykładach implementacji.
- **Przewodniki:** [Typy odbioru](/pl/guides/pickups) opisują `SELF`
  i `COURIER` jako obsługiwane typy odbioru. Nadanie w punkcie to `SELF`
  razem z `foreign_address_id`; `POCZTA` i `POINT` nie są częścią kontraktu
  API.
- **Przewodniki:** [Cykl życia zamówienia](/pl/guides/order-lifecycle) —
  `order_valuation` oznaczone jako opcjonalne, nowy krok z ponowną wyceną
  finalnego payloadu przed utworzeniem zamówienia.
- **Przewodniki:** [Dobre praktyki](/pl/guides/best-practices) —
  identyfikuj swoją integrację nagłówkiem `User-Agent`; strona
  [SDK PHP](/pl/sdk) opisuje nagłówek wysyłany przez SDK.

## 2026-08-18

Pierwsze wydanie portalu dla deweloperów, zbudowanego wokół oficjalnego
SDK PHP (AlsendoOneSDK 1.0.0):

- [API v2 (HMAC) Reference](/pl/reference/v2-legacy) z przykładami żądań
  i odpowiedzi dla każdej operacji.
- [Szybki start](/pl/quick-start), strona [SDK PHP](/pl/sdk) oraz
  [przykłady implementacji](/pl/legacy/implementation-examples) dla SDK
  i czystego PHP/cURL.
- Przewodniki integracyjne: [uwierzytelnianie](/pl/guides/authentication),
  [cykl życia zamówienia](/pl/guides/order-lifecycle),
  [typy odbioru](/pl/guides/pickups),
  [śledzenie przesyłek](/pl/guides/tracking),
  [testowanie](/pl/guides/testing) — w tym znane
  [ograniczenia sandboksa](/pl/guides/testing#ograniczenia-sandboksa) — oraz
  [dobre praktyki](/pl/guides/best-practices).
- Podstawy API: [podpisywanie żądań (HMAC)](/pl/legacy/hmac-signing)
  i [semantyka błędów](/pl/legacy/error-semantics).
- Wszystkie przewodniki po angielsku i po polsku.