JobannonceService version 1 - Velkomstside

Owned by Jon Hygom Gislason
Last updated: May 15, 2024 by Camilla Hagedorn Trolle
3 min read

Denne wiki side beskriver, hvordan man tilgår JobannonceServicen, som ny bruger, gennem links til endpoints og eksempler på brug af de forskellige webservices.

Bemærk: Disse sider løbende vil blive opdateret med ny information, og at den stadig er under udarbejdelse.

Support

For support skal I sende en email til systemforvaltning@star.dk, så jeres forespørgsel bliver oprettet i STARs sagsbehandlingssystem.

Ved spørgsmål vedrørende fejlbeskeder og andre problemer med kald til webservices skal STAR i forbindelse med fejlsøgning for det fejlende kald bruge:

  • Fuldt request vedhæftet.

  • Fuld response vedhæftet.

  • Navn på certifikatet brugt til at kalde webservicen.

Procedure for adgang

Før I kan få adgang til STARs produktionsmiljø, skal jeres integration først godkendes i STARs testmiljø. Dette inkluderer validering af jeres webservice kald, samt validering af at I følger STARs sikkerhedsmodel.

Læs mere om Procedure for tilslutning: Adgang til testmiljø.

Læs mere om Procedure for tilslutning: Adgang til produktionsmiljø.

Funktionscertifikat og adgang

Adgang til webservices i testmiljøerne kræver:

  • Whitelisting af anvendte IP adresser.

  • Oprettelse af funktionscertifikat.

Test

Whitelist af IP adresser vil blive oprettet som en del af jeres onboarding i systemet. Hvis der skal ændres i jeres whitelistede IP adresser skal I oprette en support sag.

Alle kald til webservices skal valideres med funktionscertifikatet. Som beskrevet i Procedure for tilslutning: Adgang til testmiljø | 2. Adgang til testmiljø kan funktionscertifikat til testmiljø blive oprettet af STARs Systemforvaltning eller I kan oprette jeres eget. I begge tilfælde vil Systemforvaltningen give certifikatet de nødvendige rettigheder til at tilgå webservices for jeres CVR koder.

Hvis I selv opretter et certifikat skal det have navnestandarden “Test + Virksomhedens navn + CVR-nr”, fx “Test Star 55568510”, som beskrevet under Procedure for tilslutning: Adgang til testmiljø | 2. Adgang til testmiljø . Certifikatets navn må højest være på 50 karakterer.

Ved adgang til produktionsmiljøet skal I selv udstede OCES3 organisations- eller systemcertifikat, jvf. Procedure for tilslutning: Adgang til produktionsmiljø | Aftager bliver efter gennemført test orienteret om:. Bemærk: Certifikatet I udsteder skal følge navnstandarden “Virksomhedens navn + CVR-nr”, fx “Star 55568510”, og må højest være på 50 karakterer.

Ved installation skal jeres funktionscertifikat placeres i “local machine/personal store” og jeres CA certifikat skal installeres i Trusted Root Certification Authority.

Se desuden Startpakke tilslutning til DFDG | Testcertifikat.

Produktion

Efter godkendt test skal I følge Procedure for tilslutning: Adgang til produktionsmiljø, for at få adgang til produktionsmiljøet.

JobannonceService Guide

I kan finde guide specifikt til JobannonceService i JobannonceService version 1 - Guide, som beskriver de forskellige muligheder for at tilgå systemet. Der findes i alt 4 modeller i skrivende stund (maj 2024).

Tilgangen til systemet sker på baggrund af, hvilke og hvor mange CVR numre, man ønsker adgang til. Siden indeholder eksempler på brugen af disse forskellige modeller samt brugen af disse med Postman.

I kan også finde en guide til fejlhåndtering ved at følge dette link: Fejlhåndtering

Webservices

JobAnnonceService

JobAnnonceServicen erstatter den tidligere JobAdService.

Den fulde dokumentation over JobAnnonceService kan findes på siden https://starwiki.atlassian.net/wiki/spaces/GI/pages/4011820143

En liste over alle webservices samt eksempler på dem kan findes på siden Webservices, udstilling af kodelister, Response/Request for kald samt fejlkoder

Test

JobAnnonceService kan tilgås via følgende swagger endpoints i test.

Og I skal bruge dette URL som jeres [API Url], som angivet i dokumentationen:

Produktion

JobAnnonceService kan tilgås via følgende Swagger endpoint i produktion fra release 2023-3 d. 18. september.

Og I skal bruge dette URL som jeres [API Url], som angivet i dokumentationen:

Adgangstype

Kun læsning

Særligt for brugere der er tilknyttet adgang kun til læsning af jobannoncer, skal der ved brug af “Søg“ metoden udfyldes feltet “Status“ og værdien skal være “7“. https://starwiki.atlassian.net/wiki/spaces/GI/pages/4011820143#SearchJobannonce-(GET-/v1/Jobannonce/soeg)

EscoStar Service

EscoStar servicen kan bruges til at hente stillingsbetegnelser til brug i jeres jobannoncer.

Denne service kræver, at I benytter samme certifikat, som I bruger til at kalde JobannonceService.

Se Taxonomy.EscoStarService for fuld dokumentation, og Anvendelse af ESCO-STAR klassifikation til jobannoncer.

Se desuden EscoStar Service eksempler.

Test

EscoStar service kan tilgås via følgende endpoints i test (testmiljø 1).

Produktion

EscoStar service kan tilgås via følgende endpoints i produktion:

Tilgængelighed: https://starwiki.atlassian.net/was