API v1

Første versjon av API'et for utbetalingsanmodninger er ett sett av REST metoder som er tenkt brukt i sekvensene vi beskriver her, detaljer om hver REST metode er dokumentert i vår swagger.

Feilkoder

Vi bruker følgende feilkoder:

• 400: input har feil
• 403: låneforvalter har ikke tilgang til dataene som man adresserer
• 404: data finnes ikke
• 406: forsøk ulovlig endring av data
• 500: intern feil på vår side

Feilmeldinger kommer med status og body der body inneholder beskrivelse.

Mottak

Mottak av utbetalingsanmodninger initieres av låneforvalter, og utføres i proseser som skissert under:

Godkjenning

Godkjenning av utbetalingsanmodning kan involvere saksbehandler, eller utføres automatisk for enklere tilfeller:

Utbetaling

Utbetalingsregistreringer skal sendes til Husbankens API slik at kommunene blir avstemte med låneforvalter mhp hvor mye som faktisk er brukt på hver lånesak.