API til prisdata — hent overvågningsdata ind i dine egne systemer
REST-API'et fra 4pricing.net giver dit tekniske team mulighed for at hente prisovervågningsdata ind i egne systemer (for eksempel ERP, WMS eller webshop). 4pricing tilbyder ikke færdige konnektorer: forbindelsen bygger din udvikler oven på API'et. Autentificering sker med en API-nøgle, svar leveres som standard-JSON, og specifikationen er udgivet som OpenAPI 3.0, som du kan importere direkte i din klient.
De vigtigste endpoints
API'et eksponerer overvågningsdata på niveau af det enkelte overvågede produkt: produktlisten med aktuel pris, prishistorikken for ét produkt og en mini-historik i bulk til listevisninger. Produkter identificeres på det product_id, du får retur, når du tilføjer dem — det er rutenøglen. Beløb leveres i mindste enhed, i felterne current_price_cents og price_cents sammen med valutaen, og hver post bærer det præcise tidspunkt for tjekket (henholdsvis last_scraped_at og scraped_at).
- GET /products/ — dine overvågede produkter med aktuel pris og valuta
- GET /products/{product_id}/history — prishistorikken for ét produkt med tidsstempler
- GET /products/sparklines — mini-historik i bulk, én prisrække pr. produkt
- POST /alerts/ — opret en alarm (grænseværdi, procentvist fald, lager, konkurrent)
Autentificering og rate limiting
Autentificering sker med headeren X-API-Key eller, tilsvarende, Authorization: Bearer med samme nøgle. Nøgler oprettes i panelet under API og nøgler, og hele værdien vises kun én gang, ved oprettelsen. Rate limit er 60 forespørgsler i minuttet pr. konto, delt mellem alle dine nøgler; derover svarer API'et 429 og sender headeren Retry-After.
Fordele og begrænsninger
Fordele
- Dit team kan fodre dit eget ERP/WMS direkte fra API'et uden manuel CSV-eksport (konnektoren bygger du selv)
- Alarmer kan leveres via webhook, så du slipper for at polle
- Udgivet OpenAPI 3.0-specifikation, som du importerer direkte i din klient
- Adgang til den anbefalede pris for sammenligningsgruppen, ikke kun rådata
Begrænsninger
- Rate limit på 60 forespørgsler/minut pr. konto (delt mellem alle nøgler) kræver bulk-læsninger og lokal caching ved store sortimenter
- Webhooken kræver en offentlig http/https-URL (port 80/443) i din egen infrastruktur
Kort vurdering
API'et dækker læsning af overvågningsdata og den anbefalede pris, indsendelse af dine egne priser og anvendelse af den anbefalede pris, men leveres ikke med konnektorer til ERP eller webshop. Store sortimenter har fordel af bulk-læsning (paginering, mini-historik i bulk) og lokal caching.
Specifikationstabel
| Endpoint | Metode | Svar |
|---|---|---|
| /products/ | GET | JSON-array med overvågede produkter, inkl. current_price_cents |
| /products/{product_id}/history | GET | JSON-array med historik og tidsstempler |
| /products/sparklines | GET | JSON med én prisrække pr. produkt |
| /alerts/ | POST | Den oprettede alarm med type og grænseværdi |
API vs. CSV-eksport efter behov
| Kriterium | REST-API | CSV-eksport |
|---|---|---|
| Datalatens | Data er lige så gamle som det seneste tjek | Data som på downloadtidspunktet |
| Forbindelse til ERP | Via HTTP, med en konnektor, som dit team skriver | Manuel import eller cron |
| Push-alarmer | Ja (webhook) | Nej |
Ofte stillede spørgsmål
Hvordan får jeg en API-nøgle?
Du opretter nøglen i panelet på din 4pricing.net-konto, under API og nøgler. Hele nøglens værdi vises kun én gang, ved oprettelsen — mister du den, skal du tilbagekalde nøglen og oprette en ny.
Kan jeg hente data for alle produkter på én gang?
Ja, GET /products/?skip=0&limit=200 lader dig sidedele hele det overvågede sortiment; det samlede antal rækker kommer i headeren X-Total-Count. Ved lange lister returnerer GET /products/sparklines mini-historikken for flere produkter i ét kald. Vi anbefaler en natlig synkronisering af store sortimenter og hyppigere læsninger kun på de produkter, der betyder noget.
Hvilket format har prishistorikken fra API'et?
Et JSON-array af objekter af typen {product_id, price_cents, currency, in_stock, scraped_at}, sorteret faldende efter dato. Prisen leveres i mindste enhed (price_cents), ikke i hele valutaenheder, og scraped_at er et præcist ISO 8601-tidsstempel.
Hvilke hændelser sender webhooken?
Der er én webhook-URL pr. konto, og den modtager alle de alarmtyper, du opretter: pris under en grænse, pris over en grænse, procentvist fald, tilbage på lager, en konkurrent underbyder dig, og tab af positionen som billigst. Der findes ingen alarm på selve kostprisgrænsen.