SemReg-tjenester

SemReg inneholder tjenester for å sjekke semesterregistrering. Brukes i dag av app for digitalt semesterkort (studentkort-appen).

Man kan gjerne bruke tjenesten, men endringer skjer på premissene til utvikler av studentkort-appen.

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.

Tilgjengelige grensesnitt

Sjekk gyldig semesterregistrering

Denne tjenesten sjekker om student har gyldig semesterregistrering, basert på ID. Formatet på student-ID er som følger: <feide-brukernavn>@<feide-domene>, for eksempel richared@uio.no. Returnerer true/false.

OBS: Dersom du ikke har en spesialbruker, kan du ikke sjekke studenter mot andre domener enn det som webservice-brukeren er knyttet til. Dersom du for eksempel har en webservicebruker knyttet til hioa og prøver å sjekke studenter mot domenet uio.no, så vil du får "HTTP 403 Forbidden" som svar.

URL for test: https://fs-test.uio.no/fsrest/rest/semreg/gyldig/id
URL for prod: https://fsws.usit.no/fsrest/rest/semreg/gyldig/id

Java-eksempel

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 GetGyldig {

    private static String theUrl = "https://fs-test.uio.no/fsrest/rest/semreg/gyldig/aha123@fssbkurs.no";


    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("brikernavn", "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);
        response.getEntity().writeTo(System.out);
    }
}

Hent semesterkort med bilde

Denne tjenesten henter semesterkort og bilde for en student, basert på ID. Formatet på student-ID er som følger: <feide-brukernavn>@<feide-domene>, for eksempel richared@uio.no. Returnerer JSON, spesifisert under.

OBS: Dersom du ikke har en spesialbruker, kan du ikke hente data fra andre domener enn det som webservice-brukeren er knyttet til. Dersom du for eksempel har en webservicebruker knyttet til hioa og prøver å hente studenter fra domenet uio.no, så vil du får "HTTP 403 Forbidden" som svar.

URL for test: https://fs-test.uio.no/fsrest/rest/semreg/gyldig/id
URL for prod: https://fsws.usit.no/fsrest/rest/semreg/gyldig/id

Java-eksempel

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 GetGyldig {

    private static String theUrl = "https://fs-test.uio.no/fsrest/rest/semreg/info/aha123@fssbkurs.no";


    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("brikernavn", "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);
        response.getEntity().writeTo(System.out);
    }
}

Eksempel på svar

{
	"studiested":"Universitetet i Oslo",
	"studiestedEn":"University of Oslo",
	"navn":"Peder Aas",
	"gyldigRegistrert":true,
	"datoGyldigTil":"2015-08-31",
	"termin":"2015V",
	"brukernavn":"aha123",
	"fodselsdato":"1973-01-15",
	"studentnr":"72",
	"bilde":{
		"bildeBase64":"/9j/4AAQSkZJRgABA...t+JqLCQsagSkKSFYf8\u003d",
		"bildetype":"jpg"
	}
}

 

Flyskjema for sjekken studentbevisappen gjør når gyldighet for semesterkvittering skal beregnes 

 

Publisert 26. juni 2015 10:25 - Sist endret 30. mars 2022 00:27
Del på e-post