StudInfo2-tjenester

Her beskrives resttjenestene for StudInfo2. Gamle StudInfo eksisterer kun som SOAP-tjeneste, mens StudInfo2 eksisterer både som SOAP og REST. Her beskrives REST-tjenestene.

Merk: Resultatet fra REST og SOAP er det samme, men grensesnittene er ulike. Les mer om forskjell mellom SOAP og REST på nettet.

Eksempler

Alle Java-eksempler benytter seg av Apache HTTP Client

Alle eksempler går mot vår kursbase så eventuelle data man ser her er fiktive.

TjenesteURL'er

Her angis rot-url'er i beskrivelsen av tjenestene står resten av URL'en.

For test: https://fs-test.uio.no/fsrest/rest/studinfo/<tjeneste>/<query-parametre>
For prod: https://fsws.usit.no/fsrest/rest/studinfo/<tjeneste>/<query-parametre>

Der <tjeneste> er en av disse:

  • emne
  • eksamen
  • kurs
  • undervisning
  • studieprogram
  • studieretning
  • sted
  • kode
  • fagperson
  • utveksling

Tjenestebeskrivelser

Denne tjenesten har kun et GET-grensesnitt som returnerer XML. XSD kommer senere.

Beskrivelse av uttrekk

En beskrivelse av uttrekkene finnes her: pdf

Java-eksempel

import java.io.File;
import java.io.FileOutputStream;

import org.apache.http.HttpHost;
import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.AuthCache;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.protocol.HttpClientContext;
import org.apache.http.impl.auth.BasicScheme;
import org.apache.http.impl.client.BasicAuthCache;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

public class GetBasdata {

    private static String theUrl = "https://fs-test.uio.no/fsrest/rest/studinfo/emne?institusjonsnr=185&faknr=-1&instituttnr=-1&gruppenr=-1&arstall=2014&terminkode=VÅR&originalinfo=0&sprak=B&infotermin=0";


    public static void main(String[] args) throws Exception {
        HttpHost target = new HttpHost("fs-test.uio.no", 443, "https");
        CredentialsProvider credsProvider = new BasicCredentialsProvider();
        credsProvider.setCredentials(
            new AuthScope(target.getHostName(), target.getPort()),
            new UsernamePasswordCredentials("brukernavn", "passord"));
        CloseableHttpClient client = HttpClients.custom()
            .setDefaultCredentialsProvider(credsProvider).build();

        AuthCache authCache = new BasicAuthCache();
        BasicScheme basicAuth = new BasicScheme();
        authCache.put(target, basicAuth);

        HttpClientContext localContext = HttpClientContext.create();
        localContext.setAuthCache(authCache);

        HttpGet get = new HttpGet(theUrl);

        HttpResponse response = client.execute(get);
        FileOutputStream fos = new FileOutputStream(new File("C:/temp/tester.xml"));
        response.getEntity().writeTo(fos);
        fos.close();
    }
}
Publisert 28. mars 2014 10:49 - Sist endret 24. nov. 2022 09:54