Öppna API:er
Våra öppna API:er gör det möjligt för applikationer att få tillgång till data och funktionalitet som återfinns i Miljödata MVM. Tjänsterna erbjuds som REST och SOAP tjänster och data kan hämtas i JSON eller XML formaten.
Typ av data och information som kan hämtas
- Stationsinformation
- Observationer och mätvärden
- Systemvärden
Våra web services
- ObservationsService.svc : stationsinformation, observationer och mätvärden
- DomainDefinitionsService.svc : systemvärden såsom enheter och parametrar
- SecureTokenService.svc : hanterar autentisering och utlämning av säkerhetstokens
Åtkomst
Samtliga webbmetoder kräver en säkerhetstoken som ska skickas som parameter till varje anrop. Det finns två typer av säkerhetstokens som är beskrivna i nedan tabell. De allra flesta webbmetoder accepterar en så kallad ”publik ticket” varför de flesta klienter inte behöver anropa SecureTokenService.
| Typ av token | Beskrivning | Hur får jag denna token? |
|---|---|---|
| Publik ticket | En statisk access token som kan tilldelas flera användare och sällan ändras. | Skapa ett konto i Artdatabankens
UserAdmin
.
Logga in i Miljödata MVM. Navigera till sidan "Mina sidor"
och anmäl dig som web service användare. Då får du denna säkerhetstoken. Inget godkännande krävs. |
| Dynamisk, privat token | En privat token som tilldelas inloggade användare. | Skapa ett konto i Artdatabankens
UserAdmin
.
Beställ rollen Tjänstekonsument. Rollen måste godkännas.
Logga in i Miljödata MVM. Anropa web service SecurityTokenService med inloggningsuppgifter. |
För att få en säkerhetstoken anroppas web service SecureTokenService och metod Login() med ett konto som har tilldelats rollen Tjänstekonsument. Vid lyckad autentisering returneras en säkerhetstoken som kan användas under en begränsad tidsperiod.
Stationsinformation
REST https://miljodata.slu.se/MVM/ws/ObservationsService.svc/rest
SOAP https://miljodata.slu.se/MVM/ws/ObservationsService.svc
- GetSite(siteid) -> en station
- GetSitesByEuId(euid) -> en eller flera stationer
- GetSitesByName(name) -> en eller flera stationer
Observationer och mätvärden
REST https://miljodata.slu.se/MVM/ws/ObservationsService.svc/rest
SOAP https://miljodata.slu.se/MVM/ws/ObservationsService.svc
Se vidare manualen i PDF.
Systemvärden
REST https://miljodata.slu.se/MVM/ws/DomainDefinitionsService.svc/rest
SOAP https://miljodata.slu.se/MVM/ws/DomainDefinitionsService.svc
- GetUnits() -> alla enheter
- GetUnit(unitId) -> en enhet
- GetUnitByName(name) -> en enhet
- GetParameter(parameterCode) -> en parameter
- GetParameterList(parameterCategory, onlyMenuParameters) -> en parameterlista
Tokens och autentisering
REST https://miljodata.slu.se/MVM/ws/SecureTokenService.svc/rest
SOAP https://miljodata.slu.se/MVM/ws/SecureTokenService.svc
Notera att SecureTokenService enbart stödjer https.
- Login(userName, password) -> en säkerhetstoken
- IsValidToken(token) -> en boolean som berättar om en token är giltig eller ej
- LogOut(token) -> glöm ej att logga ut din session för att förstöra din temporära säkerhetstoken
