Favrskov Kommunes avancerede API til sporing af dokumentidentifikatorer gennem hele ESDH-migrationskæden: KMD → Get Organized → WorkZone
Denne service leverer et avanceret API til at spore dokumentidentifikatorer gennem hele ESDH-migrationskæden: KMD → Get Organized → WorkZone. Systemet bruger DuckDB til at tilgå multiple Parquet-datasæt og inkluderer sofistikeret fil-hash opslag, intelligent søgning på tværs af systemer, og automatisk domæne-baseret omdirigering.
GET /lookup?q={sag-/dokumentnummer eller GO-link}
Returnerer en avanceret HTML-side med intelligent hybrid-søgning. Systemet udfører:
GET /{sagstype}/{kmd_identifier}?redirect={true|false}
Returnerer et link til Get Organized for en specifik sagstype og KMD-identifikator. Hvis redirect er sat til true (standard), vil API'et omdirigere direkte til Get Organized-linket. Hvis redirect er sat til false, vil API'et returnere et JSON-svar med linkoplysningerne.
Parametre:
sagstype: Sagstypen til forespørgsel efter GO-linket. Enten "S" eller "D"kmd_identifier: KMD-identifikatoren til forespørgsel efter GO-linket. Format som: "710-2007-518"redirect: Boolesk forespørgselsparameter, der bestemmer, om der skal udføres en omdirigering. Standard er True, og er ikke nødvendig at angive hvis der skal laves redirects.Eksempel:
GET /S/710-2007-518?redirect=false
Svar:
{
"kmd_identifier": "710-2007-518",
"sagstype": "S",
"go_identifier": "EMN-2020-00384",
"go_link": "https://go.favrskovkommune.dk/_layouts/15/CaseApp/Case/JumpTo.aspx?ID=EMN-2020-00384"
}
GET /search/kmd2go?term={search_term}&limit={max_results}&page={page_number}
Søger efter KMD- til Get Organized mappings. Resultaterne er pagineret i henhold til parametrene limit og page.
Parametre:
term: Søgeordet for at finde matchende KMD- eller GO-identifikatorerlimit: Det maksimale antal elementer, der skal returneres pr. side (standard: 10)page: Sidenummeret for paginerede resultater (skal være >= 1, standard: 1)Eksempel:
GET /search/kmd2go?term=710&limit=5&page=1
GET /search/go2wz?term={search_term}&limit={max_results}&page={page_number}
Søger efter Get Organized- til WorkZone mappings. Resultaterne er pagineret i henhold til parametrene limit og page.
Parametre:
term: Søgeordet for at finde matchende GO- eller WZ-identifikatorerlimit: Det maksimale antal elementer, der skal returneres pr. side (standard: 10)page: Sidenummeret for paginerede resultater (skal være >= 1, standard: 1)Eksempel:
GET /search/go2wz?term=1&limit=5&page=1
GET /go2wz?go_identifier={go_id}&redirect={true|false}
Konverterer et GO-identifikator til et WorkZone (WZ) link gennem intelligent multi-source opslag. Systemet søger automatisk gennem:
Understøttede GO-identifikator formater:
414794 (4-7 cifre)BOR-2020-49715-005EMN-2020-00384Parametre:
go_identifier: GO-identifikator eller URL indeholdende GO-IDredirect: Boolesk parameter for omdirigering (standard: true)Eksempel:
GET /go2wz?go_identifier=EMN-2020-00384&redirect=false
Svar:
{
"go_identifier": "EMN-2020-00384",
"wz_identifier": "12345",
"wz_link": "https://favrskov.workzone.cloud/app/client/#/Records/12345"
}
GET /{any_path_containing_go_id}?redirect={true|false}
Fallback-endpoint, der detekterer en GO-identifikator hvor som helst i forespørgselsstien og omdirigerer eller returnerer JSON som ovenfor.
Ved anmodninger via domænet go.favrskovkommune.dk opfanges enhver GO-identifikator i den fulde URL (sti eller forespørgselsstreng) og sendes videre til /go2wz-endpointet.
Redirectet bygges på den oprindelige anmodnings skema (http/https) og host, så middleware’en virker uanset om brugeren anvender HTTP eller HTTPS.
Middleware’en springer desuden anmodninger til /go2wz-ruten over for at undgå uendelige redirects.
Når applikationen kører, kan du få adgang til den interaktive API-dokumentation på: