API-portaali

Ping-API

Palauttaa sekalaisia tietoja ajankohdasta, vuodenaikojen etenemisestä ja päätelaitteesta.

GET https://api.kasperikoski.fi/ping

Muona-API

Automatisoitu ruokinnan seuranta IoT-laitteille. Fyysinen painike lähettää POST-pyynnön kun kissa on ruokittu.

POST https://api.kasperikoski.fi/muona Headers: X-API-KEY: [32-merkkinen salainen avain]

Esimerkkivastaus

{
    "success": true,
    "time": "2024-05-20T14:30:00+03:00",
    "message": "Ruokinta tallennettu onnistuneesti"
}

Pollen-API

Reaaliaikaiset siitepölytiedot ja ennusteet, jotka toimittaa Turun yliopiston siitepölytiedote.

GET https://api.kasperikoski.fi/pollen

Esimerkkivastaus

{
    "tilanne": {
        "date": "19.03.2025",
        "cities": {
            "Turku": {"L": 2, "C": 1, "K": 0, "H": 0, "P": 0, "T": 0},
            "Helsinki": {"L": 2, "C": 1, "K": 0, "H": 0, "P": 0, "T": 0},
            "Imatra": {"L": 1, "C": 0, "K": 0, "H": 0, "P": 0, "T": 0}
        }
    },
    "ennuste": {
        "date_range": "20.03.2025 - 22.03.2025",
        "cities": {
            "Turku": {"L": 3, "C": 1, "K": 0, "H": 0, "P": 0, "T": 0}
        }
    },
    "tekstit": {
        "topic": "Turun yliopiston siitepölytiedote",
        "text_date": "19.03.2025",
        "tilanne": "Lepän siitepölymäärät vaihtelevat...",
        "ennuste": "Ennustejaksolla lepän siitepölyä..."
    }
}

Tekniset tiedot

  • Kaikki vastaukset JSON-muodossa
  • Koodaus: UTF-8
  • Turvallisuus: API-avain vaadittu POST-pyynnöissä