Reference: Public Jobs API
Jobs API'et er et offentligt endpoint, der returnerer jobopslag fra en jobportal. Det kræver ingen autentificering.
API-dokumentation
Den fulde tekniske dokumentation er tilgængelig som en interaktiv OpenAPI-reference (Swagger UI):
- Åbn API-dokumentation (Swagger UI) – interaktiv reference med mulighed for at afprøve endpoints direkte
- OpenAPI-specifikation (JSON) – maskinlæsbar specifikation til kodegenereringsværktøjer og API-klienter
Overblik
| Metode | URL | Beskrivelse |
|---|---|---|
| GET | /{companyId}/api/JobBoards/{jobBoardId}/Jobs | Returnerer alle publicerede job for en jobportal |
| GET | /{companyId}/api/JobBoards/{jobBoardId}/Jobs/{id} | Returnerer et enkelt job ud fra ID |
URL-parametre
| Parameter | Type | Beskrivelse |
|---|---|---|
companyId | string | Jeres virksomheds-ID (findes i jeres INNOMATE HR-URL) |
jobBoardId | int | ID'et på jobportalen |
id | int | ID'et på et specifikt jobopslag (kun ved enkelt-job-endpoint) |
Eksempel
GET https://www.innomate.com/INNOMATE/COMPANY123/api/JobBoards/1/Jobs
Betingede felter
Visse felter i svaret (f.eks. workPlace, contactPerson, published) styres af jobportalens opsætning. Hvis et felt er deaktiveret i jobportalens konfiguration, returneres det som null. Se den fulde feltbeskrivelse i Swagger UI-dokumentationen.
Fejlkoder
| Statuskode | Beskrivelse |
|---|---|
| 200 | Succes – returnerer job (kan være et tomt array) |
| 404 | Job eller jobportal ikke fundet (kun ved enkelt-job-endpoint) |
Liste-endpointet returnerer 200 med et tomt array, hvis jobportalen ikke findes eller er arkiveret.
Se også
- Dokumentation: Ny jobportal – Opsæt jobportalindstillinger
- Vejledning: Integrer jobliste på jeres hjemmeside – Indbyg jobliste på jeres hjemmeside
- Vejledning: Tilpas design på jobportalen – CSS-variabler til visuel tilpasning