Piaskownica API EZD RP to środowisko publicznie udostępniane przez gov.pl, które pozwala integratorom testować swoje oprogramowanie z EZD RP bez wpływu na dane produkcyjne dowolnej jednostki. Każda integracja powinna zaczynać się od Piaskownicy.
Czym jest, a czym nie jest Piaskownica
- Jest publicznym środowiskiem testowym — identyczne API jak produkcja, różnica tylko w endpoincie i kluczach
- Jest wypełniona przykładową organizacją (struktura, użytkownicy testowi, JRWA)
- Nie jest miejscem na dane produkcyjne — wszystko, co tam wstawisz, jest publicznie dostępne
- Nie jest gwarancją, że produkcja zachowa się identycznie — różnice w wersjach mogą się pojawić
Jak uzyskać dostęp
- Zarejestruj wniosek o dostęp do Piaskownicy przez gov.pl (link na stronie EZD RP)
- Podaj cel użycia (np. integracja systemu FK z EZD RP)
- Otrzymujesz dane dostępowe (URL, klucze API) — typowo w 5-10 dni roboczych
- Logujesz się na Piaskownicę, sprawdzasz dane testowe
- Konfigurujesz swoje oprogramowanie z URL Piaskownicy
Jak prowadzić testy
Plan testów integracyjnych
- Test uwierzytelniania (czy klucz API działa)
- Test odczytu listy spraw / dokumentów
- Test dodania pojedynczego dokumentu do RPW
- Test obsługi błędów (np. niepoprawne dane, brak uprawnień)
- Test rate-limit (jak system reaguje na zbyt szybkie wywołania)
- Test wycofania (rollback) niedokończonej transakcji
- Test scenariusza end-to-end (Twój system → EZD RP → potwierdzenie)
Uwaga na różnice wersji
Wersja API w Piaskownicy może wyprzedzać produkcję o 1-2 release'y (testowanie nowych funkcji). Sprawdź w dokumentacji Swagger, jakie funkcje są w obu środowiskach.Pomożemy z dostępem do Piaskownicy i testami
Skompletujemy wniosek, wykonamy testy integracyjne, przygotujemy raport.
Umów konsultacjęNajczęstsze pytania
Czy Piaskownica jest płatna?
Nie — dostęp do Piaskownicy jest bezpłatny dla każdego integratora.
Jak długo czekać na dostęp?
Typowo 5-10 dni roboczych od złożenia wniosku. Można złożyć wniosek równolegle z innymi pracami przygotowawczymi.
Czy mogę testować tam dane mojej jednostki?
Nie — Piaskownica jest publiczna. Używaj tylko danych testowych. Dane produkcyjne testujemy w środowisku stagingowym dostawcy lub podczas pilotażu.