API-kokeilu

Kokeile Viikko Nron ilmaista ISO 8601 -viikkonumerorajapintaa suoraan selaimessa — ei kirjautumista, ei käyttörajoja. cURL-, JavaScript-, PHP- ja Python-esimerkit alla päivittyvät, kun muutat parametreja.

Pyynnön URL: /api/week/43/2026.json (ohjaa osoitteeseen /data/week/2026/43.json)

curl -L https://viikkonro.fi/api/week/43/2026.json

Mitä tapahtuu virheellisellä pyynnöllä?

JSON-virhevastausta ei ole — alueen ulkopuolella oleva viikko, kuukausi tai vuosi ohjataan edelleen, mutta se palauttaa sitten 404:n sivuston yleisellä HTML-virhesivulla, ei JSON-virhesisältöä. Tarkista parametrit dokumentoiduilta alueilta ennen kutsua sen sijaan, että päättelisit virheellisen pyynnön vastauksesta. Tarkemmat tiedot: Avoin data.

Usein kysyttyä

Onko käytössä nopeusrajoitus?

Ei — nämä ovat CDN:stä tarjoiltavia staattisia tiedostoja, ei nopeusrajoitettua rajapintaa.

Tarvitsenko API-avaimen?

Mikään päätepiste ei vaadi tunnistautumista.

Miksi tämä demo hakee osoitteesta /data/ eikä /api/?

/api/-ohjaus ei itsessään sisällä CORS-otsaketta (vain lopullinen /data/-vastaus sisältää), joten selaimesta tehty haku osoitteeseen /api/ voi epäonnistua cross-origin-pyynnössä muualta isännöidyltä sivulta. Palvelinpuolen koodi (curl, PHP, Python, Node) ei ole CORS:in alainen lainkaan, joten siellä toimii kumpi URL tahansa — katso yllä olevat koodiesimerkit, jotka käyttävät /api/:a, dokumentoitua kehittäjäystävällistä polkua.

Aiheeseen liittyviä sivuja

Kalenteritiedot omaan sovellukseen

Valitse ensin tarvittava aineisto: viikko, kuukausi, vuosi, pyhäpäivä tai työpäivät. Lue kenttien merkitykset ja aikavyöhykkeen käyttö. Staattiset aineistot ja avaimella käytettävä Business API ovat erillisiä rajapintoja.

Taustalähde: ISO: päivämäärien ja aikojen esitysmuodot