API date prețuri — accesează datele de monitorizare din propriile sisteme
API-ul REST 4pricing.net permite echipei tale tehnice să preia datele de monitorizare a prețurilor în propriile sisteme (de exemplu ERP, WMS sau magazin online). 4pricing nu oferă conectori gata făcuți: legătura o construiește dezvoltatorul tău pe API. Autentificarea se face cu o cheie API, răspunsurile sunt JSON standard, iar specificația este publicată ca OpenAPI 3.0, pe care o poți importa direct în clientul tău.
Endpoint-uri principale
API-ul expune datele de monitorizare la nivel de produs urmărit: lista produselor cu prețul curent, istoricul de preț al unui produs și un mini-istoric în masă pentru liste. Produsele sunt identificate prin product_id-ul returnat la adăugare — acesta este cheia de rută. Sumele vin în bani, în câmpurile current_price_cents și price_cents, împreună cu moneda, iar fiecare înregistrare poartă momentul exact al verificării (last_scraped_at, respectiv scraped_at).
- GET /products/ — produsele urmărite, cu prețul curent și moneda
- GET /products/{product_id}/history — istoricul de preț al unui produs, cu timestamps
- GET /products/sparklines — mini-istoric în masă, un rând de prețuri per produs
- POST /alerts/ — creezi o alertă (prag, scădere procentuală, stoc, competitor)
Autentificare și rate limiting
Autentificarea se face cu header-ul X-API-Key sau, echivalent, cu Authorization: Bearer și aceeași cheie. Cheile se generează din panou, în secțiunea API & chei, iar valoarea completă se afișează o singură dată, la creare. Rate limit-ul este de 60 de cereri pe minut per cont, comun tuturor cheilor tale; peste el, API-ul răspunde 429 și trimite antetul Retry-After.
Avantaje și limitări
Avantaje
- Echipa ta poate alimenta propriul ERP/WMS direct din API, fără export manual CSV (conectorul îl construiești tu)
- Alertele pot fi livrate prin webhook semnat, deci nu ești obligat să faci polling
- Specificație OpenAPI 3.0 publicată, pe care o imporți direct în clientul tău
- Acces la prețul recomandat pe grupul de comparație, nu doar la datele brute
Limitări
- Rate limit-ul de 60 de cereri/minut per cont (comun tuturor cheilor) cere citiri în masă și caching local pentru cataloage mari
- Webhook-ul necesită un URL public http/https (port 80/443) pe infrastructura ta
Verdict scurt
API-ul acoperă citirea datelor de monitorizare și a prețului recomandat, trimiterea propriilor prețuri și aplicarea prețului recomandat, dar nu vine cu conectori pentru ERP sau magazin. Cataloagele mari beneficiază de citiri în masă (paginare, mini-istoric în masă) și caching local.
Tabel de specificații
| Endpoint | Metodă | Răspuns |
|---|---|---|
| /products/ | GET | JSON array produse urmărite, cu current_price_cents |
| /products/{product_id}/history | GET | JSON array istoric cu timestamps |
| /products/sparklines | GET | JSON cu un rând de prețuri per produs |
| /alerts/ | POST | Alerta creată, cu tipul și pragul ei |
API vs. export CSV la cerere
| Criteriu | API REST | Export CSV |
|---|---|---|
| Latență date | Datele au vechimea ultimei verificări | Datele de la momentul descărcării |
| Conectare la ERP | Prin HTTP, cu conector scris de echipa ta | Import manual/cron |
| Alerte push | Da (webhook) | Nu |
Întrebări frecvente
Cum obțin o cheie de API?
Cheia se generează din panoul contului tău 4pricing.net, în secțiunea API & chei. Valoarea completă a cheii se afișează o singură dată, la creare — dacă o pierzi, revoci cheia și generezi alta.
Pot accesa datele pentru toți produsele simultan?
Da, prin GET /products/?skip=0&limit=200 poți itera întregul catalog urmărit; numărul total de rânduri vine în antetul X-Total-Count. Pentru liste mari, GET /products/sparklines aduce mini-istoricul mai multor produse într-o singură cerere. Recomandăm o sincronizare nocturnă pentru cataloagele mari și citiri mai dese doar pentru produsele importante.
Ce format are istoricul de prețuri returnat de API?
Un array JSON de obiecte {product_id, price_cents, currency, in_stock, scraped_at}, ordonat descrescător după dată. Prețul vine în bani (price_cents), nu în lei, iar scraped_at este un timestamp ISO 8601 exact.
Ce evenimente trimite webhook-ul?
Există un singur URL de webhook pe cont, care primește fiecare tip de alertă pe care îl creezi: preț sub un prag, preț peste un prag, scădere procentuală, revenire în stoc, un competitor care coboară sub prețul tău și pierderea poziției de cel mai mic preț. Nu există o alertă pe „podeaua de cost” ca atare.