Nowe REST API oraz biblioteki SDK

Z przyjemnością informujemy, że platforma POSTIVO.PL udostępnia nową wersję interfejsu API – od teraz obok dotychczasowego SOAP/WSDL udostępniamy również pełnoprawne REST API. Dodatkowo przygotowaliśmy i udostępniamy gotowe biblioteki SDK dla najpopularniejszych języków programowania, co pozwala na szybką i sprawną integrację.

Co nowego?

• REST API – dzięki REST-owym zasobom i zastosowanemu standardowi OpenAPI 3.0 oferujemy elastyczne, niezależne od środowiska programistycznego rozwiązanie do automatycznej obsługi wysyłki korespondencji listowej z poziomu własnych aplikacji.
• Biblioteki SDK – dla języków: PHP (≥ 8.2), TypeScript (Node.js), Python (≥ 3.9), C# (.NET ≥ 8.0), Java (JDK 11 +) oraz Go (≥ 1.14). Biblioteki są bezpłatne, opublikowane z otwartymi źródłami, dostępne w repozytoriach pakietów – co skraca czas wdrożenia i zmniejsza złożoność integracji.
• Dokumentacja – specyfikacja REST API dostępna jest w kilku formatach zgodnych z OpenAPI: plik YAML, interaktywna dokumentacja (Swagger „Try it out”) oraz dokumentacja podstawowa wszystkich endpointów.
• Kompatybilność – dotychczasowe SOAP/WSDL API, pozostaje w pełni wspierane, co oznacza, że klienci, którzy zintegrowali się dotychczas z SOAP-owym interfejsem, mogą przy nim pozostać (lub oczywiście przejść na REST API).

Dlaczego warto?

• Szybka integracja – gotowe SDK sprawiają, że zamiast pisać samodzielnie wrappery i obsługę połączeń HTTP/REST, można od razu wykorzystać sprawdzone pakiety.
• Niezależność technologiczna – REST API z OpenAPI gwarantuje, że integracja nie jest uzależniona od konkretnej platformy czy języka.
• Skalowalność i elastyczność – wysyłka listów i dokumentów może być w pełni zautomatyzowana, bez konieczności ręcznego przekazywania plików, co pozwala na integrację z systemami ERP, CRM, sklepami e-commerce, programami księgowymi etc.
• Utrzymanie i aktualizacje – biblioteki SDK są wersjonowane i aktualizowane, co ułatwia utrzymanie zgodności z kolejnymi wydaniami API.
• Wsparcie techniczne – przy jakichkolwiek pytaniach dostępna jest pomoc techniczna POSTIVO.PL

Dla kogo?

Nowe REST API i SDK skierowane są do firm i zespołów IT, które wykorzystują wysyłkę tradycyjnej korespondencji listowej jako część automatycznych procesów – np. wysyłka faktur, umów, wezwań, materiałów marketingowych – a które chcą uczynić ten proces bardziej efektywnym i zautomatyzowanym. Integracja z poziomu aplikacji pozwala znacznie ograniczyć pracochłonność i koszty operacyjne.

Co zrobić, by wdrożyć?

• Zapoznaj się z dokumentacją REST API.
• Wybierz odpowiednią bibliotekę SDK dla Twojego języka programowania – dostępne są tam listy instalacyjne i przykłady użycia.
• Skonfiguruj dostęp do API – wygeneruj lub uzyskaj token do API, ustaw ewentualne filtry IP (jeśli wymagane) i przetestuj integrację w środowisku Sandbox.
• Zaimplementuj wysyłkę dokumentów poprzez wywołanie odpowiednich endpointów (np. tworzenie przesyłki, kontrola statusu, pobieranie potwierdzeń nadań itp).
• Przejdź na produkcję – uruchom automatyzację wysyłki z poziomu Twoich systemów.

Przejście z SOAP API

Migracja ze SOAP-API na REST API nie jest wymagana, gdyż SOAP API pozostaje nadal funkcjonującym i wspieranym interfejsem, co daje komfort wyboru. Jeżeli jednak z jakichkolwiek powodów chcesz przenieść dotychczasową integrację na REST API to proces ten przebiega sprawnie – ponieważ REST oferuje nowoczesny, lekki interfejs.

Podsumowanie

Uruchomienie nowej wersji REST API wraz z pakietami SDK to znaczący krok naprzód w kierunku ułatwienia integracji i automatyzacji usług wysyłki korespondencji listowej w systemie POSTIVO.PL. Dzięki temu nasi Klienci i Partnerzy mogą szybciej i efektywniej wykorzystywać naszą platformę – niezależnie od wykorzystywanego języka programowania czy środowiska IT.