.svg)
Denne side beskriver ændringer til den nye implementering af Autorisationsregistrets webservice. Opdateringen indeholder en justering af den eksisterende SOAP-webservice samt introduktionen af en ny REST API. Begge services opererer på den samme underliggende datamodel og forretningslogik.
Migrering vil være nødvendig, da den eksisterende SOAP-service ikke længere vedligeholdes og forventes at blive udfaset indenfor den nærmeste fremtid.
Ændringer i SOAP-webservicen
I SOAP-servicen er håndteringen af datoer blandt andet blevet ændret. Den primære funktionalitet og datamodel er uændret.
Ændring i DateTime-felter:
- DateTime-felter specificerer ikke længere et tidsstempel (timestamp). Værdier vil blive leveret i formatet ”yyyy-mm-ddT00:00:00”, hvor tidsstemplet altså er ”nulstillet”.
- Datointervaller skal tolkes som værende inklusive både start-og slutdato. Et interval fra 2026-02-23 til 2026-02-25 dækker således hele den 23, 24, og 25 februar.
Datakontrakt (WSDL):
WSDL-filen, der beskriver servicen, er tilgængelig via linket: https://autregwebservice.stps.dk/autregservice.asmx?WSDL
Endpoint:
Webservicen vil være tilgængelig på det nye domæne: https://autregwebservice.stps.dk/autregservice.asmx
Vejledning til migrering af eksisterende integrationer
Den nye SOAP-implementering er baseret på samme WSDL datakontrakt som den eksisterende implementering. Det vil sige at namespaces, datatyper og navngivning er identisk, men at servicen hostes på et nyt domæne. Dette er alt sammen gjort for at minimere migreringsomkostningerne for eksisterende integrationer.
Da SOAP-klienter er implementeringsspecifikke, kan der ikke udarbejdes en migreringsguide til de konkrete implementeringer. I stedet foreslås det at generere klientkoden med hjælp af standardværktøjer ud fra WSDL’en for den nye SOAP-service, og anvende denne i integrationen.
Der findes en række biblioteker og værktøjer til at generere klientkode automatisk ud fra en WSDL-fil. Nedenfor er nævnt nogle eksempler.
- .NET (C#): Værktøjet dotnet-svcutil kan tilføjes til et projekt for at generere en WCF-klient fra en WSDL.
- Java: Værktøjet JAX-WS wsimport, som er en del af JDK'et, kan generere de nødvendige Java-klasser direkte fra WSDL-URL'en.
Disse værktøjer læser WSDL-kontrakten og skaber stærkt-typede klasser og metoder, som afspejler servicens operationer og datastrukturer.
Ny REST API
Autorisationsregistret vil fremover understøtte et REST API som i fremtiden vil blive brugt til at understøtte API versionering. Det nye REST API indeholder de samme services og datamodel som SOAP-servicen.
Følgende afsnit beskriver alle endpoints som er tilgænglige via REST API’n.
Endpoint: GetHealthProfessionals
Henter en liste af sundhedspersoner baseret på en række søgekriterier.
| Metode | GET |
| Sti | /api/AutReg/GetHealthProfessionals |
| Parametre | Name (string, valgfri) AuthorizationID (string, valgfri) BirthdayFrom (dato, påkrævet) BirthdayTo (dato, påkrævet) AuthorizationDateFrom (dato, påkrævet) AuthorizationDateTo (dato, påkrævet) ProfessionGroup (string, valgfri) SpecialityName (string, valgfri) AuthorizationStatus (enum, påkrævet) SeventyFiveYearsRule (enum, påkrævet) |
Endpoint: GetHealthProfessionalsCount
Returnerer det samlede antal sundhedspersoner, der matcher de specificerede søgekriterier.
| Metode | GET |
| Sti | /api/AutReg/GetHealthProfessionalsCount |
| Parametre | Samme som GetHealthProfessionals ovenfor. |
Endpoint: GetHealthProfessional
Henter en enkelt sundhedsperson via deres unikke autorisations-ID.
| Metode | GET |
| Sti | /api/AutReg/GetHealthProfessional |
| Parametre | AuthorizationID (string, valgfri) |
Endpoint: GetAllProfessionGroups
Henter en komplet liste over alle tilgængelige faggrupper.
| Metode | GET |
| Sti | /api/AutReg/GetAllProfessionGroups |
| Parametre | (Ingen) |
Endpoint: GetProfessionGroup
Henter en enkelt faggruppe via dens faggruppekode.
| Metode | GET |
| Sti | /api/AutReg/GetProfessionGroup |
| Parametre | ProfessionCode (string, valgfri) |
Endpoint: GetAllSpecialities
Henter en komplet liste over alle tilgængelige specialer.
| Metode | GET |
| Sti | /api/AutReg/GetAllSpecialities |
| Parametre | (Ingen) |
Endpoint: GetSpeciality
Henter et enkelt speciale via dets ordning og specialekode.
| Metode | GET |
| Sti | /api/AutReg/GetSpeciality |
| Parametre | Arrangement (string, valgfri) SpecialityCode (string, valgfri) |