# Changelog

What changed in this documentation, newest first. Check this page when you
come back to the docs — it tells you which pages are worth re-reading.

Entries marked **API reference** change what the
[API v2 reference](/reference/v2-legacy) describes. In most cases a field or
behaviour already worked in the API and was missing from the documentation,
not a change to the API itself — the entry says so when it is a real change.

## 2026-10-08

- **Portal:** the documentation moved to
  [api-docs.apaczka.pl](https://api-docs.apaczka.pl). The previous address,
  `api-v2-docs.apaczka.pl`, redirects to the new one — update your
  bookmarks and internal links.

## 2026-10-05

- **API reference:** documented the `push_tracking_url` order field (a
  per-order webhook URL) and the `PushTrackingNotification` webhook payload.
- **API reference:** fixed the `tracking` response examples — realistic
  status values, timestamps in ISO 8601 (UTC).
- **Guides:** the [Tracking](/guides/tracking) guide now covers push
  tracking end to end: the webhook payload, the 18 webhook statuses and how
  they map to the polling statuses, signature verification without the
  SDK, the app-level default webhook URL, and redelivery until your
  endpoint answers HTTP `200`.

## 2026-09-18

- **New section:** [Migrating from Ecolet](/migration/ecolet-overview) —
  for integrators moving from the Ecolet API: an
  [endpoint mapping](/migration/ecolet-endpoint-map) and
  [gaps and workarounds](/migration/ecolet-gaps) with a migration checklist.
- **Guides:** the service comparison example in
  [Choosing a service from the offer](/guides/choosing-a-service) now
  includes the `door_to_door` transport flag.

## 2026-09-07

- **New guide:** [Choosing a service from the offer](/guides/choosing-a-service)
  — price a shipment without `service_id`, combine `price_table` with the
  `service_structure` flags and complete the payload for the chosen
  service. Code samples verified against AlsendoOneSDK 1.1.0.
- **API reference:** the production base URL is
  `https://www.apaczka.pl/api/v2/` everywhere — the reference, the HMAC
  signing guide and the implementation examples.
- **Guides:** [Pickup types](/guides/pickups) documents `SELF` and
  `COURIER` as the supported pickup types. Parcel-point drop-off is `SELF`
  together with `foreign_address_id`; `POCZTA` and `POINT` are not part of
  the API contract.
- **Guides:** [Order lifecycle](/guides/order-lifecycle) — `order_valuation`
  is marked optional, with a new step for re-pricing the final payload
  before you create the order.
- **Guides:** [Best practices](/guides/best-practices#identify-your-integration)
  — identify your integration with a `User-Agent` header; the
  [PHP SDK](/sdk) page documents the header the SDK sends.

## 2026-08-18

First release of the developer portal, built around the official PHP SDK
(AlsendoOneSDK 1.0.0):

- [API v2 (HMAC) reference](/reference/v2-legacy) with request and
  response examples for every operation.
- [Quick start](/quick-start), the [PHP SDK](/sdk) page and
  [implementation examples](/legacy/implementation-examples) for both the
  SDK and plain PHP/cURL.
- Integration guides: [authentication](/guides/authentication),
  [order lifecycle](/guides/order-lifecycle), [pickup types](/guides/pickups),
  [tracking](/guides/tracking), [testing](/guides/testing) — including the
  known [sandbox limitations](/guides/testing#sandbox-limitations) — and
  [best practices](/guides/best-practices).
- API essentials: [request signing (HMAC)](/legacy/hmac-signing) and
  [error semantics](/legacy/error-semantics).
- All guides in English and Polish.