Hvordan starte å integere mot Yrkesskade API?
Først litt info om rolletyper
Rolletype er rollen til den skadelidte i virksomheten. Denne rollen kan påvirke hva slags kodeverk som er tilgjengelig. Det finnes mange ulike roller. De mest vanlige rolletypene er elev og arbeidstaker.
Kort fortalt
- Sett dere inn i hvilke rolletyper som relevant for din løsning
- Hent verdier fra kodeverket med valgfri HTTP klient / teknologi
- Velg de verdiene som er relevant for den gitte skade og skademeldingen med valgfri funksjonalitet / teknologi
- Send skademelding med gyldige verdier fra kodeverket med valgri HTTP klient / språk / teknologi
Sett deg inn i kodeverket
Bruk kodeverkutforsker for å sjekke hva slags verdier som er gyldige for kodeverktype + rolletype. Det er også mulig å innspisere modellene som brukes for de ulike rolletypene under Schemas her i Skademelding API OpenAPI dokumentasjonen.
API kall
Hent alle tilgjengelige typer fra kodeverket
Hent kodeverdier for en gitt type ved å bruke en av disse (den ene returerer de som en liste og den andre som et map):
Sett deg inn i skjema for innsending av skademeldinger
Skjemaet kan inspiseres her:
Merk: De fleste feltene i skjemaet må fylles ut med gyldige kodeverdier fra kodeverket.
Videre fremgangsmåte
Hent alle kodeverdier som trengs for å fylle ut skademeldingen. Deretter må man ha en måte å velge relevant verdi for hver kodeverktype, for for den gitte skaden. Hvordan det gjøres er helt fritt fram. Vi anbefaler å ta en titt på digital skademelding innsending på nav.no. Her ser du hvordan vi velger kodeverdier. Ved inspisering av nettverkslogg kan man også se innlasting av kodeverk. Vi laster alt når skjemaet lastes.
Header
For eksterne konsumenter kan headeren x-nav-ys-kilde legges til med en identifikator for hvor skademeldingen kommer fra.