# data[].attributes.body
Mahdollistaa Fingridin sähköverkon tietojen haun. Datasetistä löytyy mm. tuuli- ja aurinkovoiman tuotantoennusteet, sähkön kokonaistuotannon tiedot, sähkön siirrot maiden välillä, päästökertoimet, yms. Kaikki datasetit löytää osoitteesta https://data.fingrid.fi/fi/dataset/ .

API'n dokumentaatio löytyy osoitteesta https://data.fingrid.fi/fi/pages/api . Käyttö vaatii tilin luomisen ja sieltä saadun API-key'n.

# data[].attributes.attachment_link.description
Tämän kokonaiskapasiteettitiedon avulla voi esimerkiksi laskea tuntikohtaisen aurinkovoiman tuotantoasteen vertaamalla siihen ennustettua aurinkovoimatuotantoa toisesta Fingridin julkaisemasta aikasarjasta. Tätä kokonaiskapasiteettia ei kuitenkaan tule pitää virallisena Suomen aurinkovoimakapasiteetin määränä, sillä sen päivitys tehdään manuaalisesti sekä arvioita hyödyntäen.

# data[].attributes.body
Fingrid Oyj on Suomen kantaverkkoyhtiö, joka vastaa sähkönsiirrosta kantaverkossa, huolehtii sähkönsiirron ulkomaanyhteyksistä sekä edistää sähkömarkkinoiden toimintaa.

Fingridin tuottamat tietoaineistot sisältävät pääasiassa sähkömarkkinoihin ja voimajärjestelmään liittyvää mittaus- ja ennustetietoa.
https://data.fingrid.fi/fi/dataset/

# data[].attributes.body
OpenWeatherMap API tarjoaa monipuolisia mahdollisuuksia hakea säädataa ympäri maailman. Rajapinnan avulla voidaan hakea tietoa esimerkiksi lämpötilasta, kosteudesta, ilmanpaineesta, tuulen nopeudesta ja suunnasta, säätilasta ja auringon nousu- ja laskuajoista.

# data[].attributes.attachment_link.readable_text
Please, sign up to use our fast and easy-to-work weather APIs. As a start to use OpenWeather products, we recommend our One Call API 3.0. For more functionality, please consider our products, which are included in professional collections.

Professional collections

For professionals and specialists with middle sized project, we recommend our Professional collections, which included Current & Forecasts collection, Historical weather data collection, Weather Maps collection and other APIs.

For Enterprise level projects we provide Enterprise license, which is included all forecast products and current state, along with alerts, maps, and other products. Learn more

You can read the How to Start guide and enjoy using our powerful weather APIs right now.

Current & Forecast weather data collection

Climatic Forecast 30 days

Forecast weather data for 30 days

JSON format

Included in the Developer, Professional and Enterprise subscription plans

Global Weather Alerts
Push notifications

Get all the warnings from national weather agencies

Weather alerts are pushed to your endpoint as soon as they occur

Data feed provides all active weather alerts from the entire world

Each alert contents date, time, location, and detailed description

Monthly subscription. Please contact us to get access.

Solar Irradiance & Energy Prediction service

Solar Irradiance API

Get the solar data by particular location and calculate energy generation!

GHI, DNI, DHI indices for clear sky and cloudy sky models

Current data and forecast for 15 days ahead solar radiation data

40+ years of historical data (from January 1, 1979)

Daily aggregation for every day with hourly detalization for specified day

Historical solar irradiance and historical solar irradiance forecast bulks downloading

Available worldwide

Solar Panel Energy Prediction

Get the particular solar panel power output, based on the panel's technical characteristics!

Create unlimited number of solar panels for particular location with the desired specifications

Current and forecast for 15 days ahead solar panel power output data

40+ years of historical data (from January 1, 1979)

Daily aggregation for every day with hourly detalization for specified day

Available worldwide

Historical weather data collection

History Bulk

History Bulk provides weather data for any location for more than 40 years back
(from January 01, 1979).

Available through our Marketplace

CSV and JSON formats

Statistical Weather Data API

Statistical data on main weather parameters for any day and month of the year

The statistics is calculated based on our Historical weather data

JSON format

The weather data updated every hour

Included in Medium and Advanced subscription plans

Maps collection

Global Precipitation Maps Historical data

Current and historical weather maps for the previous 2 days

Historical precipitation data with 10-minutes step

Resolution higher than 1 km

Use as layers in Direct Tiles, OpenLayers, Leaflet, and Google Maps

Included in Professional and Enterprise subscription plans

Global Precipitation Maps Historical & Forecast data

Current, forecast and historical precipitation maps

Forecast is available for the next 6 hours for the US territory and for the next 2 hours for other global areas

The historical weather map for the previous 2 days

Data update period is every 10 minutes

Resolution higher than 1 km

Use as layers in Direct Tiles, OpenLayers, Leaflet, and Google Maps

Please contact us to get access

Other weather API's collection

Air Pollution API

Current, forecast and historical air pollution data

Forecast for 4 days ahead with 1-hour step

Air Pollution API includes both Air Quality Index and indices for CO, NO, NO₂, O₃, SO₂, NH₃, PM2.5, PM₁₀

Included in both free and paid subscriptions

Geocoding API

Geocoding API supports both the direct and reverse methods, working at the level of city names, areas and districts, countries and states

You can cap how many locations with the same name or the nearby geographic coordinates will be seen in the API response

Included in both free and paid subscriptions

Weather Stations

API for managing your personal weather stations

Connect your stations and transfer the measurements

Receive the aggregated measurements from the station

Included in both free and paid subscriptions

UV Index Deprecated

The product retired on 1st April 2021, please find UVI data in One Call API 3.0

Current UV index (Clear Sky), forecast and historical data are available for any geo location (lat/lon)

Interpretation of the UV Index and recommended protection are provided

JSON format

Weather Triggers

Simple syntax to create triggers which will be working upon the occurrence of specified weather conditions (temperature, humidity, pressure, etc.) in a certain period of time

The alerts will be generated in our service once the conditions set in the trigger are met

Included in both free and paid subscriptions

# data[].attributes.attachment_link.description
Simple and fast and free weather API from OpenWeatherMap you have access to current weather data, hourly, 5- and 16-day forecasts. Historical weather data for 40 years back for any coordinate. Weather maps, UV Index, air pollution and historical data

# data[].attributes.body
Rautatieliikenteen tietojen hakuun oleva rajapinta. Palvelusta saadaan junien kulkutiedot, sijaintitiedot, kokoonpanot (julkiset), sekä tietoa ratatöistä.

Rajapinnasta saatavien tietojen avulla on mahdollista vastata esimerkiksi seuraaviin kysymyksiin:

Onko junani aikataulussa?

Missä junani sijaitsee tällä hetkellä?

Millä junalla voin matkustaa paikasta A paikkaan B ajanhetkenä C?

Mitkä junat lähtevät ja saapuvat asemalta seuraavaksi?

Mistä vaunuista junani koostuu?

Mitä palveluita vaunut tarjoavat?

Oliko juna aikataulussa esimerkiksi kaksi kuukautta sitten?

# data[].attributes.body
https://azure.microsoft.com/en-us/products/api-management

# data[].attributes.body
https://www.avoindata.fi/en

# data[].attributes.attachment_link.description
Avoindata.fi is Finland's open data catalogue. The portal gathers all open data published in Finland in a single service. Come, use it, or publish via us!

# data[].attributes.body
https://developers.google.com/youtube/v3

YouTube Data API mahdollistaa mm. YouTube ominaisuuksien lisäämisen sovellukseen tai verkkosivustolle.

# data[].attributes.attachment_link.readable_text
Add YouTube functionality to your app

Add YouTube functionality to your site

With the YouTube Data API, you can add a variety of YouTube features to your application. Use the API to upload videos, manage playlists and subscriptions, update channel settings, and more.

Search for content

Use the API to search for videos matching specific search terms, topics, locations, publication dates, and much more. The APIs search.list method also supports searches for playlists and channels.

# data[].attributes.attachment_link.description
Add YouTube functionality to your app With the YouTube Data API, you can add a variety of YouTube features to your application. Use the API to upload videos, manage playlists and subscriptions, update channel settings, and more. Use the API to search for videos matching specific search terms, topics, locations, publication dates, and much more.

# data[].attributes.attachment_link.description
Simply put, your app receives Spotify content through the Spotify Web API.

# data[].attributes.body
Ilmatieteen laitoksen jakamia tietoja erilaisista sääilmiöistä jne.

# data[].attributes.attachment_link.title
FMI Catalogue - Finnish Meteorological Institute

# data[].attributes.body
Sivustolta saa karttoja, jotka sisältävät mm. paikannimet, tiet, rakennukset, osoitteet, vesistöt ja muut maaston kuviot, korkeussuhteet sekä hallintorajat.

Karttojen rajapintapalveluista saatavat aineistot soveltuvat esimerkiksi sovellusten taustakartoiksi ja yhdistettäviksi muihin aineistoihin.

# data[].attributes.attachment_link.readable_text
Palvelujen kautta saat sovellukseesi erilaisia maasto-, selko- ja taustakarttoja, ortokuvia, rinnevarjostuksia, korkeusvyöhykkeitä sekä kiinteistörajoja. Saatavilla on myös teematuotteita, kuten liikenneverkot, rakennukset ja osoitteet. Tuotteita on saatavilla erilaisilla rajapintatekniikoilla tuotettuna (WMS, WMTS, vektoritiilet).

Tuotteet perustuvat ortoilmakuviin, maastotietokantaan ja nimistörekisteriin ja näistä johdettuihin pienimittakaavaisiin aineistoihin. Kiinteistörajat perustuvat Kiinteistörekisteriin.

Tuotteet ovat Maanmittauslaitoksen avoimen tietoaineiston Nimeä CC 4.0 -lisenssin alaisia.

Palvelut ovat käytettävissä 24/7.

Kuvassa on esimerkkejä Maanmittauslaitoksen karttatuotteista.

Sopimus vai avoin rajapinta?

Karttakuvapalvelujen (WMS ja WMTS) käytöstä voit tehdä sopimuksen. Sopimukseen perustuvassa rajapinnan käytössä Maanmittauslaitos varmistaa käyttäjille palvelun toimivuuden ja saatavuuden sekä tarjoaa palvelun käytön tukea. Palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Sopimukseen perustuva palvelu on maksullinen. Tutustu hinnastoon.

Karttakuvapalveluja (WMTS ja Vektoritiilet) voit käyttää maksutta avoimen rajapintayhteyden kautta. Avoin rajapintayhteys toimii API-avaimen avulla. Avoimen rajapintapalvelun käytölle ei tarjota käytön tukea eikä Maanmittauslaitos takaa palvelun toimivuutta tai saatavuutta.

Lue lisää Ota käyttöösi -kohdasta.

WMS, WMTS vai vektoritiilet?

WMS- ja WMTS-tekniikalla toteutetuissa karttakuvapalveluissa tuotteet ovat rasterimuotoisia, eli kartat muodostuvat pikseleistä. Vektoritiilipalvelussa aineistot ovat pisteitä, viivoja tai alueita. Rasterikarttojen esitystyylit ovat vakioidut, kun taas vektorimuotoisten karttojen esitystyyliä voi vapaasti muokata eli voit muuttaa esimerkiksi teiden, rakennusten tai vesistön värin haluamaksesi tai vaihtaa suomenkielisen kartan ruotsinkieliseksi. Esitystyylien muokkaamiseen tarvitaan työkalu.
WMS
Palvelun valinnassa kannattaa ottaa huomioon seuraavat eroavaisuudet:
WMTS

WMS-palvelusta saatavien karttojen pikselikoko voidaan valita vapaasti, mikä helpottaa kartan näyttämistä ja tulostamista tarkasti halutussa mittakaavassa

Luonnontuho-ortokuvat ovat saatavilla vain WMS-palvelusta

palveluun saa tehdä enintään 20 milj. hakua vuodessa, yksi haku on kooltaan 256x256 pikseliä

saatavilla vain sopimukseen perustuvana palveluna

ortokuvia voi hakea aikarajauksella, esim. väriortokuvia on saatavilla vuodesta 2008 alkaen ja historiallisia ilmakuvia 1930-luvulta alkaen.

Vektoritiilet

parempi suorituskyky kuin WMS-tekniikalla tuotetussa palvelussa

sopimuksellisessa WMTS-palvelussa on monipuolisin tuotevalikoima

palvelussa tuettuna JHS180-suosituksen mukaiset kansalliset ETRS-TM35FIN (kaikki tuotteet) ja ETRS-GK karttatiilimallit (osa tuotteista)

lisäksi osa tuotteista on saatavilla myös globaalissa Web Mercator -tiilijaossa (EPSG:3857), joka yleinen useissa web-sovelluksissa

saatavilla sekä sopimuksellinen että avoin palvelu (Huom! avoimessa palvelussa on suppeampi tuotevalikoima ja vähemmän zoom-tasoja.)

käyttäjä voi vapaasti muokata karttojen esitystyyliä

käyttäjä tarvitsee työkalut esitystyylien muokkaamiseen

esitystyylien vaihtaminen on nopeaa, koska karttadataa ei tarvitse ladata uudestaan

vektoritiilikartat ovat aina teräviä ja kartalla liikkuminen sekä mittakaavan muuttaminen on nopeaa

kohteita voi hakea ominaisuustietojen perusteella

eri kieliversioiden toteuttaminen kartoista on helppoa

saatavilla tällä hetkellä vain avoin palvelu

Karttakuvapalvelu (WMTS) esittelyvideo on löydettävissä Maanmittauslaitoksen YouTube-kanavalla.

Karttakuvapalvelu (Vektoritiilet) demosovelluksessa voit tutustua aineistoihin ja katsoa esimerkkejä kartan mukautetuista esitystavoista. Lisäksi palvelusta löytyy Maanmittauslaitoksen YouTube-kanavalla esittelyvideo.

Tekninen kuvaus

Rajapinnat ja tuotteet on kuvattu tarkemmin teknisissä kuvauksissa:

Hinnasto

Karttakuvapalvelu (WMS, WMTS ja vektoritiilet)

Palvelusta saatavat aineistot ovat maksuttomia ja Maanmittauslaitoksen avoimen tietoaineiston lisenssin alaisia. Aineistojen osalta peritään vain ylläpitomaksu.

Palvelusta peritään hakumääräperusteista ylläpitomaksua. Minimimaksu on 220€ / vuosi (272,80 € / vuosi, sis. ALV 24 %).

Palvelun ylläpitomaksu perustuu hakuihin, joiden yksittäinen koko on 256 x 256 pikseliä. Maksu määräytyy todellisten hakumäärien mukaan. Taulukossa esitetään ylläpitomaksujen suuruus tietyillä hakumäärillä.

Hakumäärä (hakuja vuodessa)

Arvonlisäveroton hinta, euroa (€)

Arvonlisäverollinen hinta, euroa (€), alv. 24 %

Ota käyttöösi

Sopimuskäyttö

Karttakuvapalvelujen (WMS ja WMTS) käytöstä on mahdollista tehdä sopimus. Sopimukseen perustuvassa rajapinnan käytössä Maanmittauslaitos varmistaa käyttäjille palvelun toimivuuden ja saatavuuden. Palvelulle tarjotaan myös käyttöönoton tukea. Sopimukseen perustuva rajanpinnan käyttö on maksullista ja palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Sopimus palvelun käytöstä on voimassa toistaiseksi.

Jos olet kiinnostunut sopimuksesta, ota yhteyttä sähköpostitse verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut@maanmittauslaitos.fi.

Sopimusta varten tarvitsemme organisaation Y-tunnuksen, yhteys- ja laskutustiedot.

Avoin rajapintakäyttö

Avoin Karttakuvapalvelu (WMTS) ja (Vektoritiilet) tarjotaan myös maksuttomana ja avoimena palveluna Maanmittauslaitoksen avoimen rajapintapalvelun käyttöehtojen mukaisesti.

Avoimen Karttakuvapalvelun (WMTS) tuotevalikoima ja zoom-tasot ovat suppeammat kuin mitä sopimuskäyttäjälle on tarjolla.

Voit käyttää avointa rajapintayhteyttä vapaasti, mutta avointa rajapintapalvelua ei ole tarkoitettu suuren volyymin palvelujen käyttöön. MML ei takaa kapasiteetin riittävyyttä.

Palvelujen käyttö vaati käyttäjäkohtaisen API-avaimen. Lue lisää API-avaimen käytöstä.

Avoimen rajapintapalvelun käytölle ei tarjota käytön tukea eikä Maanmittauslaitos takaa palvelun toimivuutta tai saatavuutta. Palvelumuutoksista tiedotetaan palvelun verkkosivuilla.

Katso lisätietoja palveluista Tekninen kuvaus (WMTS) ja Tekninen kuvaus (Vektoritiilet).

Palveluosoitteet
Sopimuksellinen Karttakuvapalvelu (WMS):
https://sopimus-karttakuva.maanmittauslaitos.fi/sopimus/service/wms
Sopimuksellinen Karttakuvapalvelu (WMTS):
maastokartat
https://karttakuva.maanmittauslaitos.fi/maasto/wmts/1.0.0/WMTSCapabilities.xml

Kiinteistörajat
https://karttakuva.maanmittauslaitos.fi/kiinteisto/wmts/1.0.0/WMTSCapabilities.xml

teemakartat
https://karttakuva.maanmittauslaitos.fi/teema/wmts/1.0.0/WMTSCapabilities.xml
Avoin Karttakuvapalvelu (WMTS):
https://avoin-karttakuva.maanmittauslaitos.fi/avoin/wmts/1.0.0/WMTSCapabilities.xml

https://avoin-karttakuva.maanmittauslaitos.fi/kiinteisto-avoin/v3/kiinteistojaotus/ETRS-TM35FIN/tilejson.json

Koekäyttö

Karttakuvapalvelua (WMS) voi koekäyttää maksutta. Lupa palvelun koekäyttöön on määräaikainen.

Rajapintapalveluita haetaan koekäyttöön lomakkeella.

Maksuton palveluiden koekäyttö on tarkoitettu ainoastaan palveluiden tekniseen testaamiseen. Palveluista saatavien tietojen hyödyntäminen edellyttää tuotantosopimuksen laatimista.

Lupa ja tunnukset palvelun koekäyttöä varten lähetetään yhteyshenkilölle sähköpostitse.

Tuki

Rajapinnan tekninen tuki palvelee ma - pe klo 8 - 16. Saat tukeen yhteyden verkkolomakkeella.

Sopimuksiin ja käyttäjätunnuksiin liittyvää tukea saat osoitteesta verkkopalvelut@maanmittauslaitos.fi.

Mahdollisista häiriöistä ilmoitetaan sovellusinfossa. Palveluun tehtävistä muutoksista tiedotetaan Palvelutiedotteet -verkkosivuilla.

Anna palautetta ja kehitysehdotuksia

# data[].attributes.attachment_link.description
Palvelujen kautta saat sovellukseesi erilaisia maasto-, selko- ja taustakarttoja, ortokuvia, rinnevarjostuksia, korkeusvyöhykkeitä sekä kiinteistörajoja. Saatavilla on myös teematuotteita, kuten liikenneverkot, rakennukset ja osoitteet. Tuotteita on saatavilla erilaisilla rajapintatekniikoilla tuotettuna (WMS, WMTS, vektoritiilet). Tuotteet perustuvat ortoilmakuviin, maastotietokantaan ja nimistörekisteriin ja näistä johdettuihin pienimittakaavaisiin aineistoihin. Kiinteistörajat perustuvat Kiinteistörekisteriin.

# data[].attributes.attachment_link.readable_text
The VirusTotal API lets you upload and scan files or URLs, access finished scan reports and make automatic comments without the need of using the website interface. In other words, it allows you to build simple scripts to access the information generated by VirusTotal.

In order to use the API you must sign up to VirusTotal Community. Once you have a valid VirusTotal Community account you will find your personal API key in your personal settings section. This key is all you need to use the VirusTotal API.

Important

The VirusTotal API must not be used in commercial products or services, it can not be used as a substitute for antivirus products and it can not be integrated in any project that may harm the antivirus industry directly or indirectly. Noncompliance of these terms will result in immediate permanent ban of the infractor individual or organization.

Under all circumstances VirusTotal's Terms of Service and Privacy Policy must be respected.

By default any VirusTotal Community registered user is entitled to an API key that allows them to interact with a basic set of endpoints. Advanced research calls are available via the private API, which requires special privileges. Contact us if you would like to learn more about how to obtain access.

Note that all endpoints referenced in this guide share a common URL prefix: www.virustotal.com/vtapi/v2/.

# data[].attributes.attachment_link.description
The VirusTotal API lets you upload and scan files or URLs, access finished scan reports and make automatic comments without the need of using the website interface. In other words, it allows you to build simple scripts to access the information generated by VirusTotal. In order to use the API you mu…

# data[].attributes.body
https://developers.facebook.com/docs/

# data[].attributes.attachment_link.readable_text
App Development

Register as a developer, configure your app's settings in the App Dashboard, and build, test, and release your app.

Graph API

The primary way for apps to read and write to the Meta social graph.

App Review

Verify that your app uses our products and APIs in an approved manner.

Sign up for our monthly Facebook Developers newsletter

# data[].attributes.attachment_link.description
Register as a developer, configure your app's settings in the App Dashboard, and build, test, and release your app. The primary way for apps to read and write to the Meta social graph. Verify that your app uses our products and APIs in an approved manner.

# data[].attributes.body
https://docs.github.com/en/rest

# data[].attributes.attachment_link.description
GitHub is where over 100 million developers shape the future of software, together. Contribute to the open source community, manage your Git repositories, review code like a pro, track bugs and features, power your CI/CD and DevOps workflows, and secure code before you commit it.

# data[].attributes.body
Get started with PayPal Developer

# data[].attributes.attachment_link.readable_text
Get unlimited cash back on your favorite brands

Save as many cash back ¹ offers as you want. Earn 2, 3, 4, 5% and more after you check out with PayPal. Check offers for details. Terms and exclusions apply

Put it on your PayPal Cashback Mastercard ®. You'll earn unlimited 3% cash back ² on your PayPal purchases. And you'll earn unlimited 2% cash back on all of your other purchases. No rotating categories. No annual fee. ³ Just unlimited cash back. Plus, no impact to your credit score if you're declined ⁴.

Roll all that cash back into a high-yield PayPal Savings account. You could earn 4.30% APY. ⁵ That's earning cash on cash back.

Your transactions are encrypted, helping to keep your identity and financial info safe.

Explore the PayPal Money Hub

Find helpful articles, tips, and stories from people like you who are exercising their financial know-how to make every dollar go further.

Drive conversion with an all-in-one payments solution fueled by 430+ million active accounts and the power of AI.

A complete payments platform for businesses of all sizes

Small businesses

Accept payments securely, explore cards and loans, and streamline business operations through one platform.

Enterprise solutions

Evolve your business with end-to-end payment processing, risk management, and commerce tools customized to fit your needs.

All-in-one capabilities built with your business in mind

From card processing and POS systems to fraud management and marketing, we have the tools your business needs to thrive.

Drive conversion with the payment options your customers prefer

We're here to help businesses like yours

Every business needs the right tools to grow. From secure payment processing to helpful business insights, we've got you covered.

# data[].attributes.attachment_link.title
Digital Wallets, Money Management, and More | PayPal US

# data[].attributes.attachment_link.description
PayPal is the faster, safer way to send and receive money or make an online payment. Get started or create a merchant account to accept payments.

# data[].attributes.body
https://github.com/discord/discord-api-docs

# data[].attributes.attachment_link.readable_text
...where you can belong to a school club, a gaming group, or a worldwide art community. Where just you and a handful of friends can spend time together. A place that makes it easy to talk every day and hang out more often.

# data[].attributes.attachment_link.title
Discord | Your Place to Talk and Hang Out

# data[].attributes.attachment_link.description
Discord is the easiest way to talk over voice, video, and text. Talk, chat, hang out, and stay close with your friends and communities.

# data[].attributes.attachment_link.description
Find local businesses, view maps and get driving directions in Google Maps.

# data[].attributes.attachment_link.readable_text
We've detected that JavaScript is disabled in this browser. Please enable JavaScript or switch to a supported browser to continue using twitter.com. You can see a list of supported browsers in our Help Center.
Help Center

# data[].attributes.attachment_link.readable_text
Wikipedia is not for sale.

Hi. Please don't skip this 1-minute read. Today, our nonprofit asks for your support. It matters. When Wikipedia was created, it was one of the first spaces online where you could learn for free, without ads. This space is yours. Just 2% of our readers donate, so whatever gift you can afford helps.

- The Wikimedia Foundation, host of Wikipedia and its sister sites.

If Wikipedia has given you $3 worth of knowledge this year, please give back.
There are no small contributions: every edit counts, every donation counts. Thank you.

# data[].attributes.attachment_link.description
Wikipedia is a free online encyclopedia, created and edited by volunteers around the world and hosted by the Wikimedia Foundation.

# data[].attributes.attachment_link.readable_text
Rajapinnan avulla voi kohdistaa hakuja Finna.fi:ssä mukana olevien organisaatioiden eli suomalaisten kirjastojen, arkistojen ja museoiden aineistoihin. Esimerkiksi Suomen kansallisbibliografia Fennica ja kansallisdiskografia Viola ovat mukana rajapinnan kautta tarjottavissa aineistoissa. Rajapinnan ylläpidosta ja kehittämisestä vastaa Kansalliskirjaston kirjastoverkkopalvelut. Rajapintaa koskevat tiedustelut ja palaute: finna-posti AT helsinki.fi

Rajapinnan kutsut noudattavat muotoa:

https://api.finna.fi/v1/<toiminto>?<parametrit>

Oletuksena tulokset palautetaan json-muodossa. jsonp-muotoa käytetään mikäli kutsussa on mukana callback-parametri

https://api.finna.fi/v1/<toiminto>?callback=process

Rajapinta tukee myös CORS:ia, ja kaikki origin-osoitteet on sallittu.

Rajapintaa ei ole tarkoitettu suurten tietuejokkojen käsittelyyn (lisätietoa page-parametrin kohdalla).

Tutustu rajapinnan käyttöehtoihin ja -suosituksiin.

Pääasiallinen ja ajantasainen dokumentaatio löytyy Swagger UI:sta.

OpenAPI-määrittely on ladattavissa osoitteesta https://api.finna.fi/v1?swagger.

HUOM! Allaoleva dokumentaatio on vanhentunut. Vaikka se on edelleen oikeellista, se ei sisällä uusia ominaisuuksia kesäkuun 2016 jälkeen. Ajantasainen dokumentaatio löytyy Swagger UI:sta.

https://api.finna.fi/v1/search?<parametrit>

Haku Finnan indeksistä.

facet

Lista

Palautettavat fasetit

Lista Finnan hakuindeksin kentistä (sarake Core Fields), joita voi käyttää fasetoinnissa ( Facet Field=Yes).

Hierarkisten fasettien (format, building, sector_str_mv, category_str_mv) tulokset palautetaan kokonaisuudessaan. Muiden fasettien osalta ensimmäiset 30.

Sisältää kentät:

count: tietueiden lukumäärä

isApplied: 1 jos fasettia on käytetty kyselyn filter-parametrissa

href: AND-rajaus päälle tai pois (riippuen siitä onko fasetin koodia käytetty kyselyn filter-parametrissa). Muut operaattorit, ks. filter-kentän ohje.

children lista fasetin lapsista. Vain hierarkisille faseteille.

"facets": {
 "format": [
 {
 "value": "0/MusicalScore/",
 "translated": "Noter",
 "count": 96,
 "isApplied": false,
 "href": "?lookfor=notbok&amp;type=AllFields&amp;limit=2&amp;filter%5B%5D=building%3A%220%2FVaski%2F%22&amp;filter%5B%5D=format%3A%220%2FMusicalScore%2F%22"
 },

facetFilter

Lista

Lista palautettavien fasettiarvojen rajauksille

Mahdollistaa palautettavien fasettiarvojen rajaamisen sännöllisten lausekkeiden avulla, jotka kohdistetaan fasetin value-kenttään.

Huom: Rajattava fasetti tulee olla palautettavien fasettien joukossa.
Esimerkkejä:

Sijainti-fasetin arvoista vain Jyväskylän yliopiston päätaso:

Sijainti-fasetin arvoista vain Jyväskylän yliopistoon kuuluvat:

Aineistotyyppi-fasetin arvoista vain esnimmäiselle tasolle kuuluvat:

Aineistotyyppi-fasetin arvoista vain e-kirjat ja CD-levyt:

Mikäli säännöllinen lauseke kohdistuu hierakisen fasetin päätasoa alemmille tasoille, palautetaan kohdefasetin lisäksi hierarkiassa tätä edeltävät fasetit.
Esimerkiksi kun rajataan Aineistotyyppi-fasetista e-kirjat (facetFilter[]=format:"1/Book/eBook/"), tulos sisältää myös päätason fasetin Kirja (0/Book):

"facets": {
    "format": [
        {
            "value": "0/Book/",
            "translated": "Kirja",
            "count": 4893,
            "href": "?lookfor=sibelius&amp;type=AllFields&amp;filter%5B%5D=format%3A%220%2FBook%2F%22",
            "children": [
                {
                    "value": "1/Book/eBook/",
                    "translated": "E-kirja",
                    "count": 237,
                    "href": "?lookfor=sibelius&amp;type=AllFields&amp;filter%5B%5D=format%3A%221%2FBook%2FeBook%2F%22"
                }
            ]
        }
    ]
}

filter

Lista

Rajaukset

), joita voi käyttää rajauksissa ( Lista Finnan hakuindeksin fasettikentistä (sarake Core Fields Facet Field=Yes).
Esimerkkejä:

format: Aineistotyyppi (kirja, kuva, esine...)

building: Materiaalin tarjoava organisaatio

online_boolean: Verkossa saatavilla oleva aineisto

usage_rights_str_mv: Materiaalin käyttöoikeus

search_daterange_mv: aikaväli

Fasettikenttien mahdolliset arvot saa selville tekemällä kyselyn ilman hakusanaa ja rajauksia. Esimerkki: listataan kaikki aineistotyypit:

Rajaukset ovat oletuksena AND-rajauksia. OR tai NOT-rajausta voi käyttää lisäämällä fasetin eteen '~' (OR) tai '-' (NOT).
Esimerkkejä:

Mikäli haluat käyttää rajauksessa muita kuin fasettikenttiä, ks. type-kentän ohje.

type

Merkkijono

Hakutyyppi

AllFields (perushaku, oletus)

Voit myös kohdistaa haun suoraan indeksin (ei-fasetti) kenttiin (ks. Finnan hakuindeksin kentät, sarake Core Fields, Facet Field=No ) määrittelemällä kohdekentän hakulausekkeessa.
Esimerkki: kohdistetaan haku kenttään publication_place_txt_mv:

?lookfor=publication_place_txt_mv:pomarkku&field[]=id&field[]=publication_place_str_mv&field[]=placesOfPublication&field[]=publicationInfo&prettyPrint=1

Huom: laita fasettikenttiin kohdistuvat rajaukset filter-parametriin. Esimerkiksi:

?lookfor=format:0/Book/ ( ei tuettu)

?lookfor=&filter[]=format:0/Book/ ( tämä toimii)

sort

Merkkijono

Hakutulosten järjestys

Relevance (relevanssi, oletus)

title (nimeke)

author (tekijä)
Jos tekijöitä on useita, lajitellaan päätekijän mukaan

last_indexed desc (viimeksi indeksoidut)

main_date_str desc (uusimmat ensin)

main_date_str asc (vanhimmat ensin)

callnumber (kirjastoaineiston hyllypaikka)
Jos tietueessa on useita callnumbereita, lajittelu tehdään ensimmäisen perusteella.

page

Luku

Hakutulossivu

1-n (oletus 1). Huom! Rajapinta palauttaa korkeintaan 100 000 tulosta, eli jos limit=20, niin suurin mahdollinen page=5000. Jos on tarpeen käsitellä suurempaa joukkoa tietueita, on mahdollista rajata kerralla noudettava tietuejoukko esim. last_indexed-kentän perusteella.

limit

Luku

Tulosten lukumäärä

0-100 (oletus 20). limit=0 on hyödyllinen kun tarvitaan vain tulosten lukumäärä tai fasetoinnin tulokset.

field

Lista

Palautettavat tietuekentät.

Ks. tuetut kentät allaolevassa taulukossa. Jos ei määritelty, palautetaan alla olevassa kenttäluettelossa korostetut kentät. Jos tyhjä, ei tietueita palauteta ollenkaan.

callback

Merkkijono

callback-funktio JSONP-tilassa

Oletuksena ei käytössä

prettyPrint

Luku

Tulostetaanko JSON rivinvaihtojen kera

0, 1 (oletus 0).

Eri lähteistä tulevat samanlaiset tietueet (pääosin kirjoja) yhdistetään (deduplikoidaan) haun aikana ja hakutuloksessa näytetään ainoastaan korkeimmalle priorisoitu tietue. Käytä building-rajausta palauttaaksesi tietueita ainoastaan halutuista lähteistä.

Deduplikoidun tietueen kenttä dedupIds sisältää kaikkien samanlaisten tietueiden tunnisteet, joiden avulla voidaan tarvittaessa palauttaa halutun lähteen versio tietueesta (ks. Record-toiminto).

Hakutuloksessa esiintyvän deduplikoidun tietueen kaikkien lähteiden tietueet vaikuttavat faseteissa näkyviin arvoihin. Esimerkiksi building-fasetissa näytetään kaikkien deduplikoitujen tietueiden sijainnit. Tämän voi halutessaan estää rajaamalla palautettavien fasettien arvot facetFilter-parametrilla.

Esimerkki:

...
Lisätietoja deduplikointi-algoritmista.

https://api.finna.fi/v1/record?<parametrit>

Tietueiden nouto ID:llä

field

Lista

Palautettavat tietuekentät.

Ks. tuetut kentät allaolevassa taulukossa. Jos ei määritelty, palautetaan alla olevassa kenttäluettelossa korostetut kentät. Jos tyhjä, ei tietueita palauteta ollenkaan.

callback

Merkkijono

callback-funktio JSONP-tilassa

Oletuksena ei käytössä

prettyPrint

Luku

Tulostetaanko JSON rivinvaihtojen kera

Seuraavia kenttiä voidaan käyttää field-parametrissa:

Tietuekenttien tiedot riippuvat metadatan laadusta. Suurta osaa kenttien sisällöistä ei ole yhtenäistetty tietueiden välillä, mistä johtuen esimerkiksi tekijöiden nimet voidaan esittää eri tavoin. Kentät voivat myös sisältää kääntämätöntä tekstiä.

Mikäli pyydetty kenttä ei sisälly vastaukseen, sitä ei ole määritelty tietueelle.

accessRestrictions

Aineiston käyttörajoitukset, mikäli tiedossa.

Esimerkkejä:

"accessRestrictions": [
    "University of Turku local network, remote access with Univ. of Turku username",
    "Turun yliopiston verkossa, etäkäyttö TY:n tunnuksilla"
]

"accessRestrictions": [

    "ELEKTRA-lisenssi"
]

"accessRestrictions": [

    "K11"
]

authors

Lista

Kaikki tekijät

"authors": {
    "main": "Bowie, David",
    "secondary": [
        "Spiders from Mars"
    ]
}

"authors": {
    "main": "Ozric Tentacles",
    "corporate": "Ozric Tentacles,"
}

buildings
Lista

Sijainti (hierarkkinen). Sisältää kentät:

"buildings": [
    {
        "value": "0/TAIY/",
        "translated": "Taideyliopisto"
    },
    {
        "value": "1/TAIY/tea/",
        "translated": "Teatterikorkeakoulun kirjasto"
    },
    {
        "value": "2/TAIY/tea/1/",
        "translated": "Lainattavat"
    }
]

childRecordCount

Luku

Tietueen lapsitietueiden lukumäärä. Tämän tiedon pyytäminen voi kasvattaa vasteaikaa merkittävästi.

"childRecordCount": 0

edition

Merkkijono

Painos, laitos tai versio

"edition": "10. osin uud. laitos"

"edition": "Pidennetty versio"

embeddedComponentParts

Lista

Tietueeseen sisältyvät osakohteet. Käytössä esimerkiksi äänitteissä. Tämän tiedon pyytäminen voi kasvattaa vastauksen kokoa ja vasteaikaa merkittävästi.

"embeddedComponentParts": [
    {
        "id": "viola.305175",
        "title": "Juppihippipunkkari",
        "authors": [
            "Koistinen, Petteri, säveltäjä",
            "Alanko, Ilkka, sanoittaja",
            "Neljä Ruusua, esittäjä"
        ],
        "otherAuthors": [
            "Koistinen, Petteri, säveltäjä",
            "Alanko, Ilkka, sanoittaja",
            "Neljä Ruusua, esittäjä"
        ]
    },
    {
        "id": "viola.305176",

...

events

Lista

Tietueeseen liittyvät tapahtumat, kuten valmistus, käyttö, muotoilu ja näyttely (museoaineisto)

"events": {
    "valmistus": [
        {
            "type": "valmistus",
            "date": "800 - 1050, viikinkiaika, rautakausi",
            "materials": [
                "metalli",
                "hopea"
            ]
        }
    ],
    "näyttely": [
        {
            "type": "näyttely",
            "name": "Raision museo -ja kulttuurikeskus Harkon arkeologinen näyttely",
            "description": "26.5.2004 - 31.12.2006"
        }

    ]

}

formats
Lista

Tietueen aineistotyypit (hierarkkinen).

Esimerkki: e-kirja on kirjan alalaji. Rajapinta palauttaa koko hierarkian ylhäältä alas:

"formats": [
    {
        "value": "0/Book/",
        "translated": "Kirja"
    },
    {
        "value": "1/Book/eBook/",
        "translated": "E-kirja"
    }
]

fullRecord

Merkkijono

Tietueen alkuperäinen metadata (MARC, EAD, LIDO, DC, QDC).

genres

Lista

Aineiston "genret". Teoksen teema tai tyylilaji kuvaillaan kohdassa subjects.

"genres": [
    "Electronic books",
    "Conference proceedings"
]

"genres": [
    "DVD-levyt"
]

"genres": [
    "kirja-arvostelut"
]

hierarchyParentId

Lista

Emotietueen ID. Käytössä esimerkiksi arkistoaineistoss (EAD).

"hierarchyParentId": [
    "narc.VAKKA-192941.KA_VAKKA-62641.KA"
]

hierarchyParentTitle

Lista

Emotietueen nimeke. Käytössä esimerkiksi arkistoaineistoss (EAD).

"hierarchyParentTitle": [
    "Aa Diaarit"
]

"hierarchyParentTitle": [
    "The rise and fall of Ziggy Stardust and the spiders from Mars"
]

identifierString

Tietueen tunniste, ei yksilöivä. Katso myös id.

Esimerkkejä:

Museoaineistossa inventaarionumero:

"identifierString": "201190a20"

Tietokannoissa tunniste:

"identifierString": "FSD"

imageRights
Lista

Kuvien käyttöoikeudet:

"imageRights": {
    "copyright": "CC BY 4.0",
    "link": "http://creativecommons.org/licenses/by/4.0/deed.fi",
        "description": [
            "Finna-palvelussa julkaistuja Helsingin kaupunginmuseon kuvia voi käyttää vapaasti, myös kaupallisessa käytössä.

             Kuvaa ei saa muunnella ilman lupaa ja kuvan yhteydessä on mainittava kuvaaja(jos tiedossa) ja Helsingin kaupunginmuseo.

             Finnassa näytettävät kuvat lisensoidaan Nimeä 4.0 Kansainvälinen (CC BY 4.0) -lisenssillä.

             Palvelussa näytettävät kuvat eivät ole painolaatuisia. Jos tarvitset painolaatuisen kuvan tai sinulla on muuta kysyttävää,

             ota yhteyttä Helsingin kaupunginmuseon kuva-arkistoon: http://www.helsinginkaupunginmuseo.fi/kuva-arkisto"

        ]
}

images
Lista

Tieteen kuvien osoitteet.

"images": [
    "/Cover/Show?id=hkm.HKMS000005%3Akm002w3s&fullres=1&index=0"
]

Kuvaa luettaessa osoitteen alkuun tulee lisätä https://api.finna.fi, esimerkiksi:

https://api.finna.fi/Cover/Show?id=hkm.HKMS000005%3Akm002w3s&fullres=1&index=0

Kirjojen tietuekuvan linkki palauttaa 10x10 pikselin kokoisen läpinäkyvän .gif-kuvan mikäli oikeaa kuvaa ei löydy.

institutions

Lista

Organisaatio. Katso myös buildings

"institutions": [
    {
        "value": "LUC",
        "translated": "Lapin korkeakoulukirjasto"
    }
]

nonPresenterAuthors
Lista

Tekijät ilman esittäjiä. Katso myös presenters.

"nonPresenterAuthors": [
    {
        "name": "Doyle, Arthur Conan",
    },
    {
        "name": "Attwood, David",
        "role": "ohj."
    }
]

onlineUrls
Lista

Online-linkit (kirjastoaineisto). Sisältää kentät:

url: linkin URL

text: linkin teksti (ei käännetty)

source: tietueen tietolähde (organisaatio)

value: organisaation koodi

translated: nimi käännettynä

"onlineUrls": [
    {
        "url": "http://eca.europa.eu/portal/page/portal/publications/Journal",
        "text": "Elektroninen julkaisu (PDF)",
        "source": {
            "value": "selma",
            "translated": "Eduskunnan kirjasto - Selma"
        }
    }
]

openUrl

Merkkijono

OpenURL (kirjastoaineisto).

otherLinks

Lista

Muut tietueen linkit. Käytetään ainakin arvosteltujen teosten merkitsemiseen.

"otherLinks": [
    {
        "heading": "Arvosteltu teos",
        "title": "Viimeiset runonlaulajat",
        "author": "Martti Haavio"
    }
]

physicalLocations

Lista

Arkistomateriaalin fyysiset sijainnit.

"physicalLocations": [
    "Historiska och litteraturhistoriska arkivet",
    "Helsingfors, Nationalbiblioteket"
]

placesOfPublication

Julkaisupaikka

"placesOfPublication": [
    "New York, NY  :"
]

presenters
Esittäjät (ks. myös nonPresenterAuthors).

details (lista): Lisätietoja. Esittäjät saattavat merkintätavasta riippuen olla myös olla tässä kentässä.

"presenters": {
    "presenters": [
        {
            "name": "Carola",
            "role": "esitt."
        },
        {
            "name": "Sarmanto, Heikki",
            "role": "esitt."
        },
        {
            "name": "Heikki Sarmanto Trio",
            "role": "esitt."
        }
    ],
    "details": [
        "Carola (voc), Heikki Sarmanto Trio: Heikki Sarmanto (p), Tapani Tamminen (b), Reino Laine (dr), Esa Pethman (fl, ts)"
    ]
}

publicationEndDate

Merkkijono

Viimeinen julkaisuajankohta (kausijulkaisuissa) tai ensi-illan ajankohta (elokuvissa).

"publicationEndDate": "2003"

Edelleen jatkuva julkaisu merkitään usein vuotena 9999:

"publicationEndDate": "9999"

publishers

Julkaisijat

"publishers": [
    "Published by E. & F.N. Spon for the Royal Institute of British Architects"
]

previousTitles / newerTitles

Tieto voi sisältyä myös kenttään recordLinks

rating
Lista

Käyttäjien julkaisulle antamien arvostelujen keskiarvo ja lukumäärä. Käytössä seuraavissa aineistotyypeissä: 0/Book/, 0/Journal/, 0/Sound/ ja 0/Video/.

"rating": {
    "average": 2.5,
    "count": 3
}

rawData

Lista

Tietueen kaikkien indeksikenttien sisältö, pois lukien fullRecord.

recordLinks

Lista

Tietueiden väliset linkit. Linkki voidaan muodostaa ainakin nimekkeen tai isn:n perusteella.

link

type: linkin muodostamisperuste, kuten title tai isn

value: tieto linkin muodostamiseksi

exclude

translated: käännetty kuvaus tietueen suhteesta linkitettyyn tietueeseen

"recordLinks": [
    {
        "value": "Baskervillen koira",
        "link": {
            "type": "isn",
            "value": "978-951-1-22851-6",
            "exclude": "arto.1567282"
        },
        "translated": "Muu suhde"
    }
]

"recordLinks": [
    {
        "value": "Julkisuuden salaisuudet : pakinoita ja satiireja journalismin ja julkisuuden kiehtovasta maailmasta",
        "link": {
            "type": "title",
            "value": "Julkisuuden salaisuudet : pakinoita ja satiireja journalismin ja julkisuuden kiehtovasta maailmasta"
        },
        "translated": "Muu suhde"
    }
]

recordPage

Merkkijono

Relatiivinen linkki tietueen sivulle Finnassa. Lisää linkin alkuun https://www.finna.fi

sectors

Lista

Sektori (kirjasto, museo tai arkisto).

"sectors": [
    {
        "value": "0/mus/",
        "translated": "Museo"
    }
]

series
Lista

Sarjatiedot

name: sarjan nimi

additional (valinnainen)

number: järjestysluku (valinnainen)

issn: issn-numero (valinnainen)

"series": [
    {
        "name": "Ursan julkaisuja",
        "additional": "0357-7937;",
        "number": "28",
        "issn": "0357-7937"
    }
]

"series": [
    {
        "name": "Laatukirjasto"
    }
]

shortTitle

Merkkijono

Päänimeke. Katso myös title ja subTitle.

"shortTitle": "Parhaat ruokasienet"

source

Tietueen lähde

"source": [
    {
        "value": "keski",
        "translated": "Keski-kirjastot"
    }
]

subjects
Lista

Asiasanat/aiheet. Lista koostuu listoista, joissa on ensimmäisenä yläkäsite ja sen jälkeen mahdolliset alakäsitteet. Esim:

"subjects": [
    [
        "Holmes, Sherlock,",
        "fikt."
    ],
    [
        "elokuvat",
        "Iso-Britannia",
        "2000-2009"
    ],
    [
        "jännityselokuvat"
    ],
    [
        "rikoselokuvat"
    ]

]

subTitle

Merkkijono

Alanimeke. Katso myös title ja shortTitle.

"subTitle": "sieniopas"

title
Merkkijono

Koko nimeke. Katso myös shortTitle ja subTitle

"title": "Parhaat ruokasienet : sieniopas"

titleSection

Merkkijono

Nimekkeeseen liittyvä osan numero, jos nimeke kuuluu sarjaan. Katso myös series.

"titleSection": "3."

urls
Lista

Tietueeseen liittyvät resurssit ja toiminnot ulkoisissa järjestelmissä. Sisältää kentät:

"urls": [
    {
        "url": "http://www.makupalat.fi/",
        "desc": "Tietokannan käyttöliittymä"
    },
    {
        "url": "http://www.makupalat.fi/fi-FI/Info/",
        "desc": "Tietokantaopas"
    }
]

year

Merkkijono

Vuosi (esimerkiksi julkaisuvuosi, valmistusvuosi). Käytetään myös main_date_str-fasetissa.

"year": "1761"

Tietueet hakusanalla "sibelius":

https://api.finna.fi/v1/search?lookfor=sibelius

CD-levyt hakusanalla "sibelius":

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=format:"1/Sound/CD/"

Verkossa saatavilla olevat kuvat hakusanalla "sibelius"

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"

Verkossa saatavilla olevat kuvat hakusanalla "sibelius", hakutulokset ja fasetointi organisaation mukaan

https://api.finna.fi/v1/search?lookfor=sibelius&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"&facet[]=building

Tietueet vuosilta 1870-1890

https://api.finna.fi/v1/search?lookfor=&filter[]=search_daterange_mv:"[1870%20TO%201890]"

Kaikkien tietueiden aineistotyypit

https://api.finna.fi/v1/search?lookfor=&facet[]=format

Kaikki verkossa saatavilla olevat kuvat

https://api.finna.fi/v1/search?lookfor=&filter[]=online_boolean:"1"&filter[]=format:"0/Image/"

Tietueet sallitun käyttötavan mukaan (esimerkiksi "Saa muokata, myös kaupallinen")

https://api.finna.fi/v1/search?lookfor=&filter[]=usage_rights_str_mv:usage_B

Mukana olevat organisaatiot, nimet ruotsiksi

https://api.finna.fi/v1/search?lookfor=&limit=0&facet[]=building&lng=sv

Tietueet, joissa tekijänä "sibelius"

https://api.finna.fi/v1/search?lookfor=sibelius&type=Author

Yksittäisen tietueen noutaminen ID:n perusteella

https://api.finna.fi/v1/record?id=fennica.123

Kahden tietueen noutaminen ID:n perusteella

https://api.finna.fi/v1/record?id[]=fennica.123&id[]=fennica.124

Hakusana voi sisältää monimutkaisemman hakulausekkeen, esimerkiksi kohdistuksen tiettyyn indeksikenttään tai loogisen hakuoperaattorin:

Haku hakusanoilla "sibelius" ja "festival"

https://api.finna.fi/v1/search?lookfor=sibelius+AND+festival

Joissakin Finnasta löytyvistä MARC-tietueista on emokohteeseen yhdistettyjä osakohteita. Tällaisia ovat esim. lehtien artikkelit ja kappaleet musiikki-CD:llä. Finnan käyttöliittymässä tällaiset osakohteet näytetään emokohteen tietuenäytön Sisältö/kappaleet-välilehdellä, ja listassa näytettävä metadata näkyy emokohteen MARC tietueen 979-kentissä. Rajapinnassa 979-kentät on typistetty yhdeksi kentäksi, joka sisältää vain osakohteiden ID:t toistetussa a-osakentässä. Osakohteiden tiedot voidaan tarvittaessa hakea rajapinnan record-toiminnolla käyttäen 979-kentän a-osakentistä löytyviä ID:itä.

Esimerkkitietue, joka sisältää osakohteita: https://api.finna.fi/v1/record?id=viola.49914&field[]=fullRecord

Lisätietoja hakusyntaksista.

Rajapinta tukee myös Finnan tarkennetun haun syntaksia samoin parametrein kuin tarkennetun haun hakutuloksessa, esimerkiksi:

https://api.finna.fi/v1/search?sort=relevance&bool0%5B%5D=AND&lookfor0%5B%5D=sibelius&type0%5B%5D=AllFields&lookfor0%5B%5D=festival&type0%5B%5D=AllFields&lookfor0%5B%5D=&type0%5B%5D=AllFields&join=AND&filter%5B%5D=~language%3A"fin"&limit=20

29.1.2016 Ensimmäinen versio
5.2.2016 Lisätty tietoa osakohteiden käsittelystä
17.3.2016 Korjattu virheellinen URL kentän 'images' kuvauksessa.
22.6.2016 Lisätty esimerkkejä käytöstä
26.9.2016 Lisätty CORS-tuki
17.1.2017 Lisätty maininta Swagger UI:sta ja määrittelystä
17.1.2017 Rajapintaan lisätty subjectsExtended ja imagesExtended (ks. Swagger UI)
5.1.2018 Lisätty maksimitulosmäärä ja ohjeita suurempien tulosjoukkojen hakuun

# data[].attributes.attachment_link.description
Rajapinnan avulla voi kohdistaa hakuja Finna.fi:ssä mukana olevien organisaatioiden eli suomalaisten kirjastojen, arkistojen ja museoiden aineistoihin. Esimerkiksi Suomen kansallisbibliografia Fennica ja kansallisdiskografia Viola ovat mukana rajapinnan kautta tarjottavissa aineistoissa. Rajapinnan ylläpidosta ja kehittämisestä vastaa Kansalliskirjaston kirjastoverkkopalvelut. Rajapintaa koskevat tiedustelut ja palaute: finna-posti AT helsinki.fi Rajapinnan kutsut noudattavat muotoa: https://api.finna.fi/v1/ ?