Hintadatan API — käytä seurantadataa omista järjestelmistäsi
4pricing.netin REST API:n avulla tekninen tiimisi voi viedä hintaseurantadataa omiin järjestelmiinsä (esimerkiksi ERP-, WMS- tai verkkokauppajärjestelmään). 4pricing ei tarjoa valmiita liittimiä: yhteyden rakentaa kehittäjäsi API:n päälle. Tunnistautuminen tapahtuu API-avaimella, vastaukset ovat standardia JSON-muotoa ja määrittely on julkaistu OpenAPI 3.0 -muodossa, jonka voit tuoda suoraan omaan asiakassovellukseesi.
Tärkeimmät rajapinnat
API tarjoaa seurantadatan seurattavan tuotteen tasolla: tuotelistan nykyhintoineen, yhden tuotteen hintahistorian sekä massana haettavan minihistorian listanäkymiä varten. Tuotteet tunnistetaan product_id-tunnisteella, joka palautetaan tuotetta lisättäessä — se toimii reittiavaimena. Summat tulevat pienimpinä yksiköinä kentissä current_price_cents ja price_cents yhdessä valuutan kanssa, ja jokainen tietue sisältää tarkistuksen tarkan ajankohdan (last_scraped_at ja vastaavasti scraped_at).
- GET /products/ — seuraamasi tuotteet nykyhintoineen ja valuuttoineen
- GET /products/{product_id}/history — yhden tuotteen hintahistoria aikaleimoineen
- GET /products/sparklines — massana haettava minihistoria, yksi hintarivi tuotetta kohden
- POST /alerts/ — luo hälytys (raja-arvo, prosentuaalinen lasku, varastotilanne, kilpailija)
Tunnistautuminen ja pyyntörajat
Tunnistautuminen tapahtuu X-API-Key-otsakkeella tai vastaavasti Authorization: Bearer -otsakkeella samalla avaimella. Avaimet luodaan hallintapaneelin API ja avaimet -osiossa, ja avaimen koko arvo näytetään vain kerran, luontihetkellä. Pyyntöraja on 60 pyyntöä minuutissa tiliä kohden, ja se jaetaan kaikkien avaintesi kesken; rajan ylittyessä API vastaa koodilla 429 ja lähettää Retry-After-otsakkeen.
Edut ja rajoitukset
Edut
- Tiimisi voi syöttää dataa omaan ERP- tai WMS-järjestelmäänsä suoraan API:sta ilman manuaalista CSV-vientiä (liittimen rakennat itse)
- Hälytykset voidaan toimittaa webhookiin, joten sinun ei tarvitse kysellä dataa jatkuvasti
- Julkaistu OpenAPI 3.0 -määrittely, jonka tuot suoraan omaan asiakassovellukseesi
- Pääsy vertailuryhmän suositushintaan, ei pelkkään raakadataan
Rajoitukset
- Tilikohtainen raja 60 pyyntöä minuutissa (jaettu kaikkien avainten kesken) edellyttää massahakuja ja paikallista välimuistia suurissa valikoimissa
- Webhook vaatii julkisen http/https-URL-osoitteen (portti 80/443) omassa infrastruktuurissasi
Lyhyt arvio
API kattaa seurantadatan ja suositushinnan lukemisen, omien hintojen lähettämisen ja suositushinnan käyttöönoton, mutta siihen ei kuulu liittimiä ERP- tai verkkokauppajärjestelmiin. Suuret valikoimat hyötyvät massalukemisesta (sivutus, massahaettu minihistoria) ja paikallisesta välimuistista.
Teknisten tietojen taulukko
| Rajapinta | Metodi | Vastaus |
|---|---|---|
| /products/ | GET | JSON-taulukko seuratuista tuotteista, mukana current_price_cents |
| /products/{product_id}/history | GET | JSON-taulukko historiasta aikaleimoineen |
| /products/sparklines | GET | JSON, jossa yksi hintarivi tuotetta kohden |
| /alerts/ | POST | Luotu hälytys tyyppeineen ja raja-arvoineen |
API vs. tarvittaessa tehtävä CSV-vienti
| Kriteeri | REST API | CSV-vienti |
|---|---|---|
| Datan viive | Data on viimeisimmän tarkistuksen ikäistä | Data latauksen hetkeltä |
| Yhteys ERP-järjestelmään | HTTP:n kautta, tiimisi kirjoittamalla liittimellä | Manuaalinen tai cron-tuonti |
| Push-hälytykset | Kyllä (webhook) | Ei |
Usein kysytyt kysymykset
Miten saan API-avaimen?
Luot avaimen 4pricing.net-tilisi hallintapaneelista, API ja avaimet -osiosta. Avaimen koko arvo näytetään vain kerran, luontihetkellä — jos kadotat sen, mitätöi avain ja luo uusi.
Voinko hakea kaikkien tuotteiden tiedot samanaikaisesti?
Kyllä, GET /products/?skip=0&limit=200 antaa sinun selata koko seurattua valikoimaa sivuittain; rivien kokonaismäärä tulee X-Total-Count-otsakkeessa. Pitkiä listoja varten GET /products/sparklines palauttaa usean tuotteen minihistorian yhdellä kutsulla. Suosittelemme suurille valikoimille yön yli tehtävää synkronointia ja tiheämpiä hakuja vain tärkeimmille tuotteille.
Missä muodossa API palauttaa hintahistorian?
JSON-taulukkona objekteja {product_id, price_cents, currency, in_stock, scraped_at}, järjestettynä päivämäärän mukaan laskevasti. Hinta tulee pienimpinä yksiköinä (price_cents), ei kokonaisina valuuttayksiköinä, ja scraped_at on tarkka ISO 8601 -aikaleima.
Mitä tapahtumia webhook lähettää?
Tiliä kohden on yksi webhook-URL-osoite, ja se vastaanottaa kaikki luomasi hälytystyypit: hinta raja-arvon alle, hinta raja-arvon yli, prosentuaalinen lasku, tuote takaisin varastossa, kilpailija alittaa hintasi sekä halvimman hinnan aseman menetys. Kustannusrajalle sellaisenaan ei ole hälytystä.