API:n virhetyypit
Jokainen API:n virhe on JSON-muotoinen ongelmakuvaus. Siinä on code-kenttä ja type-osoite, joka päättyy samaan koodiin. Kun avaat type-osoitteen, päädyt koodin omalle sivulle suomeksi tai englanniksi sen mukaan, kumpaa selaimesi pyytää.
Kentät title ja detail ovat suomeksi, kun pyynnön Accept-Language-otsake pyytää suomea, ja muuten englanniksi. Kenttä detail kertoo juuri sinun tapauksesi syyn, joten lue se ennen sivua.
- Pyynnössä ei ole kelvollista avainta
API:n 401-vastaus: avain puuttuu, se lähetettiin väärin, sitä ei tunneta tai se on mitätöity. Tarkista Authorization-otsake ja avaimen alkuperä.
- Avain on vanhentunut
API:n 401-vastaus: avaimen luonnissa valittu päättymispäivä on ohitettu. Ylläpitäjä luo uuden avaimen, ja sinä vaihdat sen skriptiisi tai työkaluusi.
- Paketti ei salli tätä pyyntöä
API:n 403-vastaus: avain on kelvollinen, mutta paketti tai avaimen oma käyttöoikeus ei kata pyyntöä. Detail-kenttä nimeää yhden kuudesta syystä.
- Tästä polusta ei löytynyt mitään
API:n 404-vastaus: polun verkkotunnus tai tunniste ei johda mihinkään avaimen organisaatiossa. Hae nimi tai tunniste ensin luettelovastauksesta.
- Parametri ei kelpaa
API:n 400-vastaus: yksi pyynnön arvo ei kelpaa päätepisteelle. Kenttä parameter nimeää arvon, ja detail-kenttä kertoo, mitä se hyväksyy.
- Tunnin pyyntöraja on käytetty
API:n 429-vastaus: avain on käyttänyt kaikki pakettinsa sallimat pyynnöt tällä tasatunnilla. Odota Retry-After-otsakkeen sekunnit ja lähetä uudelleen.
- Vientiä kootaan jo
API:n 409-vastaus: organisaation vientiä kootaan vielä. Odota, kunnes viennin tila on ready, ja lataa se tai aloita sen jälkeen seuraava vienti.
- Vienti on vanhentunut
API:n 410-vastaus: viennin tiedoston säilytysaika päättyi, eikä API enää anna sitä. Aloita uusi vienti samoilla valinnoilla ja lataa se ajoissa.
Julkaistu 27. lokakuuta 2026 · Tarkistettu 27. lokakuuta 2026