API EZD RP pozwala systemom zewnętrznym uzyskiwać dostęp do zasobów EZD RP oraz korzystać z jego modułów i funkcji. W tej instrukcji przedstawione są metody API wykorzystywane do realizacji konkretnego celu biznesowego – założenia sprawy. Opisana jest także zalecana kolejność wywoływania metod.
Aby założyć pustą sprawę w systemie EZD RP, należy wywołać metodę:
POST /ezdrp/integrator/v2/sprawy
Jednym z wymaganych parametrów jest idWykaz, który należy wcześniej uzyskać. W tym celu najpierw należy pobrać dostępne schematy JRWA. Wywołujemy metodę:
GET /ezdrp/integrator/v2/jrwa/schematy
Przykładowa odpowiedź:
{
"lista": [
{
"id": "98a62721ccb246fba5845eccc6edb72b",
"nazwa": "JRWA 2025",
"czyGlowny": true,
"dataUtworzenia": "0001-01-01T00:00:00",
"dataOdDostepnosci": "2025-02-24T00:00:00"
}
]
}
Odnajdujemy właściwy wykaz, korzystając z metody:
GET /ezdrp/integrator/v2/jrwa/schematy/{idSchemat}/wykazy
Na podstawie wybranego id schematu (np. 98a62721ccb246fba5845eccc6edb72b), wywołujemy metodę:
GET /ezdrp/integrator/v2/jrwa/schematy/98a62721ccb246fba5845eccc6edb72b/wykazy
W odpowiedzi otrzymujemy listę wykazów klas końcowych. Załóżmy, że chcemy założyć sprawę w klasie o symbolu 000. Wyszukujemy jej identyfikator (id), np.:
"id": "f7393580a07e46a3bb1abd6aec787790",
"nazwa": "Powoływanie i odwoływanie wojewody i wicewojewodów oraz określanie zakresów kompetencji wicewojewodów",
"czyNAS": false,
"czyZUdostepnienia": false,
"symbol": "000",
"kategorieArchiwalne": [
"A"
]
Mając już identyfikator wykazu (idWykaz), możemy przejść do wywołania metody tworzącej pustą sprawę:
POST /ezdrp/integrator/v2/sprawy
Przykładowe zapytanie:
{
"idWykaz": "f7393580a07e46a3bb1abd6aec787790",
"tytul": "Sprawa z API",
"kategoriaArchiwalna": "A",
"numer": 0,
"rokZalozenia": 2025
}
Przykładowa odpowiedź:
{
"idSprawa": "73068d730a5c4931974dca6d307d13dc",
"idPrzestrzenRobocza": "0b9faa508f1f441cad58ff37cb412511",
"idJRWASchematWykaz": "f7393580a07e46a3bb1abd6aec787790",
"idStanowiskoInicjujacy": "42ad53c712ff49aca1151ba21f3dd84a",
"idJednostka": "d86c9552c3ed4e1b8b474e53b6e2c120",
"tytul": "Sprawa z API",
"kategoriaArchiwalna": "A",
"znak": "SSPASI.000.3.2025",
"typProwadzenia": "2",
"rokZalozenia": 2025,
"dataRejestracji": "2025-03-27T09:54:55.4614092+01:00",
"terminZalatwienia": "2025-04-26T09:54:55.1368844+02:00",
"dataWszczecia": "2025-03-27T09:54:55.4614053+01:00",
"numer": 4,
"idPodmiotWlascicielBiznesowy": "34357ea948b0433a8c2d0728bb342124"
}
W wyniku wywołania sprawa zostaje zarejestrowana w systemie i będzie widoczna w zakładce Sprawy.
