Match.JobannonceService (Version 2, 2025-1) [UDV] (Søgninger)
Siden er en UDV udgave manuelt ændret.
Metoder
GetJobannoncer (POST /v1/Jobannonce/SoegAnnoncer)
Find jobannoncer via en søgning
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
match.staronly.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
request | requestDTO |
| 1 |
|
- sidenummer | Int | MinInclusive: 1 | 1 | Sidenummer der ønskes returneret (side 1 er første side) |
- resultaterPrSide | Int | MinInclusive: 1 | 1 | Antal resultater på hver side |
- soegestreng | String | MinInclusive 1 | 0-1 | Fritekst søgestreng |
- sortering |
| 1 | Angivelse af sortering i forhold til Bedst match, Publiceringsdato eller ansøgningsfrist | |
xxx |
|
|
| Over på sin egen service |
- undtagetJobannonceIdListe | List(strings) |
|
| Bruges til at excludere jobannonce ID man ikke ønsker med ud igen. (Bruges F.eks. når Jobnet skal hente annoncer til automatch, for ikke at få samme annoncer med ud i 2 kald som er vist i første) |
- tidligstePubliceringstidspunkt | DateTime |
| 0-1 | Tidspunkt for tidligst medtaget jobannonce |
- hotjob |
| 1 | Annoncen er et hotjob | |
udlandsk | Bruge landekoeliste i stedet | 1 | Om jobannoncer er i udland (True) ellers Danmark (False) | |
INaerheden | Boolean? |
|
| Noget er tæt på når det er? |
EksterntJob | Bool |
|
| Jobs der er crawlet? |
kunGeoPoints | Bool |
|
| Bruges til at vise på kort, skal ud i sin egen service. |
- ingenFastArbejdsplads |
| 1 | Angiver, at der ikke er fast arbejdssted. | |
- mindsteUgentligeArbejdstimer (WorkHourMin) | Int |
| 0-1 | Mindste antal ugentlige arbejdstimer. Er kun angives hvis jobbet er DeltidHøjst antal ugentlige arbejdstimer. |
- hoejsteUgentligeArbejdstimer | Int |
| 0-1 | Højst antal ugentlige arbejdstimer. |
fleksJob | Kan vi nøjes med fleksjob i jobtype? | 1 | Angiver om det er et Fleksjob så true ellers false | |
søgeFacetter | SearchFacets |
|
| Forskellige søgeobjekter Facetterne opdeles i sine egne |
- regionsnummer | Liste(.RegionTypeCodeList) |
| 0 - * | En liste af regioner du vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad region der er. |
- landekode | Liste(int) | Koden kan hentes fra GetLand i EkstenreData | 0 - * | En liste af lande du vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad lande der er. |
kommunenummer | Liste(KommuneTypeCodeList) | Hvor kan man søge på dette? | 0 - * | En liste af kommuner du vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad kommuner der er. |
- postnummer | Liste(PostNummerTypeCodeList) | Hvor kan man søge på dette? | 0 - * | En liste af postnumre du vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad postnumre der er. |
arbejdsgivernavn | Liste(String) | Fritekstsøgning? | 0 - * | En liste af arbejdsgivernavnedu vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad arbejdsgivernavneder er. |
- beskaetigelsesomraade | Liste(String) |
| 0 - * |
|
- erhvervsomraade | Liste(String) |
| 0 - * |
|
- conceptUriDa | Liste(String) |
| 0 - * |
|
- aliasIdentifier | Liste(uuid) | Hvor kan man søge på dette? | 0 - * | Alias identifier til stillingsbetegnelsen. |
- tidsbegraensetAnsaettelse |
| 0 - 1 | Boolean kan nulles for begge dele | |
- deltid |
| 0 - 1 | Boolean kan nulles for begge dele | |
- jobtype |
| 0 - * | En liste af Jobtyper vil søge på, hvis der ikke sendes noget med ind vil den ikke kigge på dette og du vil få alt ud uanset om eller hvad Jobtyper er. | |
- handicapIngenHaendring |
| 0 - 1 | Boolean kan nulles for begge dele | |
Findes længere oppe allerede | SearchFacets |
|
|
|
(WorkHourPartTime) | Liste(Kodeliste) Jobtype? | SearchFacets | 0 - 1 |
|
afgraensendeRektangle | afgraensendeRektangleDTO | En DTO |
|
|
- minX | Int |
|
|
|
- maxX | Int |
|
|
|
- minY | Int |
|
|
|
- maxY | Int |
|
|
|
soegningFraPostnummer | EksterneData.PostNummerTypeCodeList |
| 0 - 1 | Søgefiltrering udfra postnr |
- afstandsSøgningDTO | DTO |
| 0-1 |
|
- - laengdegrad | float | Denne spiller sammen med GeoDistance | 1 | Geografisk udgangspunkt |
- - breddegrad (Location) | float | Denne spiller sammen med GeoDistance | 1 | Geografisk udgangspunkt |
- - soegeradius | Int |
| 1 | Radius i km for cirkulær geografisk afgrænsning |
ErWorkInDenmarkJob | Skal vi lave et Søgeprofil element i stedet, som så har en kodeliste med de instancer man kan kalde i Ankiro? | 1 | Hvis “Ja” får du kun Work in denmark og den spørg på Work in denmark profilen i Ankiro. | |
- soegeprofil |
|
| Angiver hvilken ankiroinstance man vil kalde | |
- soegPaaLignendeStillinger | Bool | Model:
Automatch? Hvis der ikke er nok bruges dette til at finde flere | 1 | Hvis der skal søges på ligende stillinger så true ellers false |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetJobannonceResponseDto |
| 1 | DTO for at hente frister |
- jobannoncer | jobannonceDtoCollection |
| 1 | En samling af jobannoncer |
- - jobannonce | jobannonceDto |
| 0 - * |
|
- - regionsnummer (Region) |
|
| Regionsnummer på arbejdssted | |
- - landekode (Country) | EksterneData.Myndighedsrelation (Version 1, [UDV] 2024-3) | GetLand (GET /v1/Land) |
| 1 | Landekode på arbejdssted Det er ISO 3166-1 alfa-2 man får tilbage |
- - kommunenummer (Municipality) |
| 0-1 | Kommunenummer på arbejdssted | |
- - postnummer (PostalCode) |
| 0-1 | Postnummer på arbejdssted | |
- - arbejdsgivernavn (HiringOrgName) | String |
| 0 - 1 | Arbejdsgiverens navn |
- - beskaetigelsesomraade (OccupationAreas) | String |
| 1 | Beskæftigelsesområde niveau 1 |
- - erhvervsomraade (OccupationGroups) | String |
| 1 | Beskæftigelsesområde niveau 2 |
- - conceptUriDa (Occupations) | String |
| 1 | Stillingsbetegnelse angivet som ESCO-STAR kode. |
- - aliasIdentifier | uuid |
| 0 - 1 | Alias identifier til stillingsbetegnelsen. |
- - tidsbegraensetAnsaettelse | Boolean |
| 1 | TidsbegraensetAnsaettelse ellers Fastansættelse |
- - Deltid | Boolean | 1 |
| |
- - JobAnnouncementTypeNavn | string |
| 0 - 1 | Om jobannonce er “Job med løntilskud", "Almindelige vilkår", "Fleksjob", "Egnet til førtidspensionister", "Rotationsjob", "Egnet til efterlønnere og seniorer", "Virksomhedspraktik" eller "Handicap ingen hindring" |
- - ingenFastArbejdsplads (WorkPlaceNotStatic) | boolean |
| 1 | Ingen fast arbejdsplads |
- - deltid (WorkHourPartTime) | boolean |
| 1 | Hvorvidt ansættelsen er deltid. |
- - JobannonceId (Id) | String |
| 1 | Id på jobannonce |
- - Value |
|
|
|
|
- - Count |
|
|
|
|
- - SouthWestCorner |
| Geo lokation få regen service |
|
|
- - NorthEastCorner |
| Geo lokation få regen service |
|
|
- - bredegrad (Latitude) |
| Geo lokation få regen service | 0-1 | Bredegrad for arbejdssted |
- - laengdegrad (Longitude) |
| Geo lokation få regen service | 0-1 | længdegrad for arbejdssted |
- - jobannonceURL | string |
| 0-1 | Benyttes til de eksterne jobannoncer |
- - soegeFacetterCount | soegeFacetterCountDto |
| 0-1 | Collection af facetter og deres count. Returneres ikke for Automatch |
- - - beskaetigelsesomraade | Int |
| 1 | Antal af jobannoncer under denne facet |
- - - erhvervsomraade | Int |
| 1 | Antal af jobannoncer under denne facet |
- - - conceptUriDa | Int |
| 1 | Antal af jobannoncer under denne facet |
- - - tidsbegraensetAnsaettelse (EmploymentType) | Int |
|
| Antal af jobannoncer under denne facet |
- - - xxx (WorkHours) | Int |
|
| Antal af jobannoncer under denne facet |
- - - jobtype (JobAnnouncementType) | Int |
| 1 |
|
- - - handicapIngenHaendring
| Int |
| 1 | Antal af jobannoncer under denne facet |
- - - deltid (WorkHourPartTime) | Int |
| 1 | Antal af jobannoncer under denne facet |
- - - beskaetigelsesomraader
| Liste(BeskaetigelsesomraadeFacetDto) |
| 1 | Liste af fagområder under denne facet |
- - - - navn | String |
| 1 | Navn på fagområdet |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for det givne fagområde |
- - - erhvervsomraader | Liste(ErhvervsomraadeFacetDto) |
| 1 | Liste af fagkategorier under denne facet |
- - - - navn | String |
| 1 | Navn på kategorien |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne fagkategori |
- - - stillingsbetegnelser | Liste(StillingsbetegnelseFacetDto) |
| 1 | Liste af stillingsbetegnelser under denne facet |
- - - - navn | String |
| 1 | Navn på stillingsbetegnelsen |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne stillingsbetegnelse |
- - - stillingsAliasser (Senere version) | Liste(StillingsAliasFacetDto) |
| 1 | Liste af stillingsaliasser under denne facet |
- - - - navn | String |
| 1 | Navn på stillingsaliasset |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for det givne stillingalias |
- - - regioner | Liste(RegionFacetDto) |
| 1 | Liste af regioner under denne facet |
- - - - navn | String |
| 1 | Navn på regionen |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givner region |
- - - kommuner | Liste(KommuneFacetDto) |
| 1 | Liste af kommuner under denne facet |
- - - - navn | String |
| 1 | Navn på den givne kommune |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne kommune |
- - - lande | Liste(LandFacetDto) |
| 1 | Liste af lande under denne facet |
- - - - navn | String |
| 1 | Navn på det givne land |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer for det givne land |
- - - ansaettelsesvilkaar | Liste(AnsaettelsesvilkaarFacetDto) |
| 1 | Liste af ansættelsesvilkår under denne facet |
- - - - navn | String |
| 1 | Navn på det givne ansættelsesvilkår |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for det givne ansættelsesvilkår |
- - - ansaettelsesvarigheder | Liste(AnsaettelsesvarighedFacetDto) |
| 1 | Liste af ansættelsesvarighed under denne facet |
- - - - navn | String |
| 1 | Navn på den givne ansættelsesvarighed |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne ansættelsesvarighed |
- - - arbejdstider | Liste(ArbejdstidFacetDto) |
| 1 | Liste af arbejdstider under denne facet |
- - - - navn | String |
| 1 | Navn på den givne arbejdstid |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne arbejdstid |
- - - handicapvenlige | Liste(HandicapvenligFacetDto) |
| 1 | Liste af handicapvenlige facetter under denne dto |
- - - - navn | String |
| 1 | Navn på den givne handicapvenlige facet |
- - - - antalJobannoncer | Int |
| 1 | Antal jobannoncer inden for den givne handicapvenlige facet |
1Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
1010 | Unknown cpr | The submitted cpr is unknown to the system |
4575 | You are not authorized | You are not authorized to execute the operation |
GetJobannoncerGeoPoints (POST /v1/Jobannonce/SoegAnnoncerGeoPoints)
Find jobannoncer via en søgning og retuner geo punkter
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
match.staronly.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
|
|
|
|
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
|
|
|
|
|
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
|
|
|
|
|
|
|
|
|
GetJobannonceUrl (GET /v1/Jobannonce/HentAnnonceURL/{JobannonceId})
Henter en jobannonce URL på de eksterne jobannoncer ud
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
match.staronly.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
jobannonceId (Id) | string |
| 1 | Id på jobannonce |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
jobannonceURL (URL) | string |
| 1 | Benyttes til de eksterne jobannoncer |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
4575 | You are not authorized | You are not authorized to execute the operation |
13000 | Invalid jobannonceId | Der kunne ikke findes nogen Jobannonce på det ID |
13002 | Ingen URL | Der fandtes ingen URL på den Jobannonce |