Öppna API:er
Å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 och navigera till sidan "Mina sidor" där aktivering av privat token görs på samma sätt som den publika. |
Version 2
Version 2 är vårt nyare API baserat på OpenAPI Specification 3. Det är en REST tjänst och data returneras som JSON. Det har förbättrad urvalsmöjlighet, uppgraderad respons och stora anrop med förgenererade uttag.
| Resurs | Beskrivning |
|---|---|
| AllFullSamples | Förgenererade utsökningar som möjliggör hämtning av alla prover inklusive observationer och mätvärden uppdelat på kemi och biologi. Observera att detta ger mycket stora filer! Överföring och lagring behöver kunna hantera stora datamängder. |
| Common | En uppsättning med anrop för olika systemvärden. |
| FullSamples | Hämtar prover inklusive alla observationer och mätvärden. Urval på provId eller genom filtrering på parametrar. Observera att uttag kan bli stora och ta tid att skapas och laddas ned. Se Swagger-dokumentationen för begränsningar i uttagsstorlek. |
| SamplesIds | Hämtar en lista med provIDn. Filtrering på urvalsparametrar. |
| Samples | Hämtar prover utan enskilda observationer eller värden. För biologiprover hämtas i förekommande fall biologiska index. Urval på provId eller genom filtrering på parametrar. |
| SampleSites | Hämtar information om provplatser. Urval på provplatsId eller genom filtrering på parametrar. |
| Stations | Hämtar information om stationer och deras tillhörande provplatser. Urval på stationsId eller genom filtrering på parametrar. |
Version 1
Version 1 är ersattes januari 2024 av version 2. Version 1 är fortfarande aktivt men kommer att fasas ut och vi uppmanar därför alla att använda version 2.