Demodata API – Startlån

Hva er dette?

Demodata API-et brukes til å generere test- og demodata for utbetalingsanmodninger i Startlån.

Tjenesten gjør det mulig å:

• teste integrasjoner
• verifisere dataflyt
• demonstrere funksjonalitet

All datagenerering skjer i demo-miljø og påvirker ikke produksjonsdata.

---

Hvordan bruke API-et

1. Autentisering av klient

Forespørsler til vårt API må autentiseres med klientsertifikat som inneholder låneforvalters organisasjonsnummer. Det kan f.eks være i p12 format.

curl -X GET --cert-type P12 --cert test.p12:'<passord>' "https://api.demo.husbanken.no/startlan/demodata/7c1d3175-288d-4e0a-9fa2-49bc13d55d5b"

Klientens IP adresse må i tillegg være lagt inn i vår whitelist.

---

2. Endepunkter

Miljø	URL
Demo	https://api.demo.husbanken.no

---

3. Opprette bestilling

POST /startlan/demodata

kan opprette to typer bestillinger:

• DEFAULT – bruker forhåndsdefinert oppsett
• CUSTOM – lar deg styre hvilke data som genereres

---

Eksempel på CUSTOM request (curl)

curl -X POST "https://api.demo.husbanken.no/startlan/demodata" \
  --cert-type P12 \
  --cert testcert.p12:'<passord>' \
  -H "Content-Type: application/json" \
  -d '{
    "variant": "CUSTOM",
    "detaljer": [
      {
        "kommunenummer": "1508",
        "laneforvalter": "INTRUM",
        "orgnummer": "929911709",
        "antall": 1,
        "formal": "KJOP"
      },
      {
        "kommunenummer": "1804",
        "laneforvalter": "INTRUM",
        "orgnummer": "929911709",
        "antall": 1,
        "antallUtbetalingsmottakere": 2,
        "epost": "test@kommune.no",
        "formal": "REFINANSIERING"
      }
    ]
  }'

---

4. Hente status

GET /startlan/demodata/{bestillingId}

curl -X GET --cert-type P12 --cert test.p12:'<passord>' "https://api.demo.husbanken.no/startlan/demodata/7c1d3175-288d-4e0a-9fa2-49bc13d55d5b"

---

Eksempel på respons

{
  "id": "9db594bd-6c93-4423-853a-02cc58132c25",
  "variant": "CUSTOM",
  "status": "FERDIG",
  "antall": 2,
  "ferdige": 2,
  "feilmelding": null,
  "logg": [
    "sak 233107 for soknad f097959b-d66a-472f-a0a6-f5d7b25f97e2 ferdig behandlet",
    "sak 233108 for soknad ff476396-84db-41eb-81cd-26f96e7f06be ferdig behandlet"
  ]
}

---

Viktige begreper

Variant

• DEFAULT – standard generering
• CUSTOM – styrt via request

---

Formal

• KJOP – kjøp av bolig
• REFINANSIERING – refinansiering

---