Wskazówki dotyczące API metody PragmaPay
Kompatybilność wsteczna
- Za złamanie kompatybilności wstecznej nie uznajemy dodania w odpowiedziach i powiadomieniach nowych pól.
- Oznacza to, że musisz tak zaimplementować deserializację/denormalizację, aby pomijać nadmiarowe pola przy mapowaniu na Twoje obiekty systemowe.
- Jeśli nie zaimplementujesz obsługi nowododanych w wersji kolejnej minor API pól, Twoja integracja nadal będzie działała poprawnie.
Kolejność powiadomień
- System PragmaPay nie gwarantuje wysyłki powiadomień w kolejności generowania.
- W powiadomieniach znajduje się pole
timestamp, którego wartość kieruje na dokładny moment zdarzenia systemowego powodującego wysyłkę powiadomienia.- Można zatem pomijać powiadomienia o niższym
timestampod uprzednio obsłużonego w obrębie pojedynczego typu powiadomienia oraz klucza kierującego na obiekt systemowy, którego dotyczy powiadomienie.
Sortowanie tablic
- System PragmaPay nie gwarantuje, że tablice JSON będą posortowane.
- Jeśli w tablicy liczy się kolejność elementów, to każdy element ma numerator lub inne pole nadające się do sortowania.
- Np. number(int), createdAt(date)