🔌API tilgang og testing av scoops

Denne veiledningen er for deg som skal hente data fra Webtemp ved hjelp av vårt REST API. Dokumentasjonen forutsetter teknisk kompetanse – det gis ikke opplæring i bruk av API.

---

🔐 Hvordan få tilgang til API

For å få tilgang til Webtemp sitt API, må du:

1. Være Webtemp-kunde eller få tilgang via en kunde.
2. Bestille API-klient via kundesenteret
3. I bestillingen må følgende spesifiseres:
   • Hvilke scopes du trenger
   • Bekreftelse på at du forstår kostnad og ansvar

Merk: Etablering og løpende bruk faktureres til dataeier (kunden). Det signeres også egen datatilgangsavtale.

---

🧠 Teknisk krav

Webtemp sitt API er et REST API med JSON som dataformat. Autentisering skjer via OAuth2.

⚠️ Viktig: Du må ha kompetanse på REST, JSON og OAuth2 for å bruke dette API-et. Webtemp gir ikke opplæring eller veiledning i grunnleggende API-bruk.

Du vil motta:

• Client ID: din.1111.klient
• Client name: for eksempel "Hente ut data"
• Tenant ID: 1111 (en unik identifikator for konsern)
• API secret key: genereres én gang – denne må lagres sikkert
• Lenke til dokumentasjon

---

🚀 Kom i gang med Postman

Vi anbefaler å teste tilgangen for å se at du får ut ønsket data, dette kan gjøres i eksempelvis Postman eller andre programmer du er kjent med. 

1. Benytt følgende token: https://api.webtemp.no/oauth/connect/token
2. Sett opp autentisering i Postman:
   • Grant type: Client Credentials
   • Client ID: din.1111.klient
   • Client Secret: din secret key
3. Trykk “Get new access token”

Ved korrekt oppsett får du en access token du kan bruke videre.

---

🔎 Eksempel: Hente firma og avdeling

Hent alle firma:

GET https://api.webtemp.no/rest/nextapi/1111/Firms

Eksempelsvar:

{
  "items": [
    {
      "id": 3000001,
      "name": "Firma navn",
      "orgNo": "11111111111"
    }
  ]
}

Hent avdelinger for et firma:

GET https://api.webtemp.no/rest/nextapi/1111/Departments?idfirm=3000001

Eksempelsvar:

{
  "items": [
    {
      "id": 2,
      "idFirm": 3000001,
      "name": "Avdeling1"
    },
    {
      "id": 3,
      "idFirm": 3000001,
      "name": "Avdeling2"
    }
  ]
}

---

👥 Eksempel: Hent ansatte i avdeling

GET https://api.webtemp.no/rest/nextapi/1111/Employees?idfirm=3000001&idDepartment=2

Eksempelsvar:

{
  "items": [
    {
      "idCandidate": 3000009,
      "firstname": "NAVN",
      "lastname": "ETTERNAVN",
      "email": "[e-mail]",
      "statusCaption": "Nettregistrert til sak",
      "cityPlace": "Bergen",
      "mobilePhone": "44332211",
      "dateOfBirth": "2000-02-05T00:00:00"
    }
  ]
}

📌 Tips: Bruk idfirm og idDepartment fra tidligere API-kall som parametre i forespørselen.

---

📚 Videre lesning

• Full API-referanse: API dokumentasjon
• API oppsett
• Begrensning av resultater i API-et

---