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. 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. 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 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 — dla integratorów przechodzących z API Ecolet: mapowanie endpointów oraz braki i obejścia z checklistą migracji.
• Przewodniki: przykład porównania usług w przewodniku Wybór usługi z oferty uwzględnia teraz flagę transportu door_to_door.

2026-09-07

• Nowy przewodnik: Wybór usługi z oferty — 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 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 — order_valuation oznaczone jako opcjonalne, nowy krok z ponowną wyceną finalnego payloadu przed utworzeniem zamówienia.
• Przewodniki: Dobre praktyki — identyfikuj swoją integrację nagłówkiem User-Agent; strona SDK PHP 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 z przykładami żądań i odpowiedzi dla każdej operacji.
• Szybki start, strona SDK PHP oraz przykłady implementacji dla SDK i czystego PHP/cURL.
• Przewodniki integracyjne: uwierzytelnianie, cykl życia zamówienia, typy odbioru, śledzenie przesyłek, testowanie — w tym znane ograniczenia sandboksa — oraz dobre praktyki.
• Podstawy API: podpisywanie żądań (HMAC) i semantyka błędów.
• Wszystkie przewodniki po angielsku i po polsku.