Introduktion til api.jobindsats.dk

Version 3 af api.jobindsats.dk er klar til brug

Du kan tilgå den nye version via api.jobindsats.dk/v3. Med API’et kan du hente data direkte fra alle målinger på jobindsats.dk. Version 3 er en moderniseret udgave med øget fokus på brugervenlighed og fleksibilitet.

Du kan læse mere om den nyeste version her: Nyhed - Jobindsats får nyt API

Bruger du en ældre version?

Denne side dækker version 3.

Hvis du stadig benytter version 2, finder du indholdet her: Brugervejledning til Version 2.

Vi anbefaler alle nye brugere at starte med version 3.

Hvad er et API?

Når du henter data på Jobindsats, kan du vælge at bruge vores API (Application Programming Interface). Det er en softwareløsning, hvor du, ved hjælp af programmering, kan automatisere processen, når du henter data fra vores databank.

Skal du fx bruge de samme data igen og igen, kan du ved hjælp af programmering lave en direkte forbindelse mellem Jobindsats og det program, du bruger til at arbejde videre med data i. Fx hvis du arbejder med data i et regneark, såsom Excel.

Når du først har oprettet forbindelsen og hentet data, slipper du for at gå på Jobindsats og hente de samme data ned manuelt hver gang, der kommer opdaterede tal. I stedet kan du opdatere dine egne tabeller og grafer med nye tal direkte i det program, du arbejder i.

Hvordan får jeg adgang?

For at du kan bruge api.jobindsats.dk, skal du have en adgangsnøgle. Den får du ved at sende en mail til jobindsats-api@star.dk, hvor der i emnefeltet står "Ansøgning om adgang til api.jobindsats.dk".

Før du sender en ansøgning om adgang til API-løsningen, opfordrer vi dig til at læse om
behandling af dine personoplysninger i tilknytning til en brugerprofil her.

I ansøgningsmailen skal følgende fremgå:

• Navn
• Organisation
• E-mailadresse

Du vil herefter modtage en nøgle inden for 14 dage, hvis oplysningerne i ansøgningen er fyldestgørende. I forbindelse med ferie kan der gå længere tid.

Vi giver i udgangspunktet kun én nøgle per organisation. Hvis du arbejder i en organisation, der allerede har adgang, vil du derfor blive bedt om at kontakte organisationens kontaktperson for at få organisationens nøgle. Hvis din organisation ikke har en nøgle, vil I blive bedt om at udpege en kontaktperson.

Når du modtager nøglen, får du udleveret retningslinjerne for at bruge api.jobindsats.dk.

Vi opfordrer til, at du læser retningslinjerne, før du går i gang.

Hvordan kommer jeg i gang?

Du finder brugervejledningen i venstremenuen Brugervejledning til Version 3, hvor du finder instrukser og eksempler på, hvordan du bruger løsningen.

Hvad gør jeg, hvis jeg oplever fejl?

Hvis du oplever fejl, når du bruger api.jobindsats.dk, kan du sende en mail til jobindsats-api@star.dk.

I emnefeltet skal du skrive ”vedr. fejl på api.jobindsats.dk”.

I mailen skal det fremgå, hvornår fejlen er opstået, og du må meget gerne indsætte et kald (uden nøgle/token), der leder til fejlen.