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 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. 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 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 — for integrators moving from the Ecolet API: an endpoint mapping and gaps and workarounds with a migration checklist.
• Guides: the service comparison example in Choosing a service from the offer now includes the door_to_door transport flag.

2026-09-07

• New guide: Choosing a service from the offer — 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 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 — order_valuation is marked optional, with a new step for re-pricing the final payload before you create the order.
• Guides: Best practices — identify your integration with a User-Agent header; the PHP 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 with request and response examples for every operation.
• Quick start, the PHP SDK page and implementation examples for both the SDK and plain PHP/cURL.
• Integration guides: authentication, order lifecycle, pickup types, tracking, testing — including the known sandbox limitations — and best practices.
• API essentials: request signing (HMAC) and error semantics.
• All guides in English and Polish.