API prețuri și webhooks — prețuri, istoric și alerte, accesibile programatic
Datele de preț din 4pricing sunt accesibile prin API REST: lista de produse, istoricul de preț, comparațiile pe grup, oportunitățile și briefingul zilnic, plus trimiterea propriilor prețuri și a vânzărilor zilnice. Webhook-ul semnat trimite un POST către URL-ul tău la alerte, la fiecare preț aprobat (price.apply, price.revert) și când briefingul e gata (briefing.ready). Nu există conectori gata făcuți pentru ERP sau magazine: legătura o construiești tu pe API.
Ce poți construi peste API-ul 4pricing
API REST cu cheie
Te autentifici cu antetul X-API-Key (sau cu cheie Bearer prc_live_…), creată și revocată din panou. Cheia cere un plan activ.
Citiri gratuite
Lista de produse, istoricul de preț și comparațiile pe grup se citesc fără consum de credite.
Credite doar la citirea paginilor
Un apel consumă credite doar când se citește o pagină de magazin: căutare, produs nou din link, reîmprospătare sau membru nou de grup din link.
Limită de 60 de cereri pe minut
Limita e per cont; specificația OpenAPI e disponibilă pentru integrare.
Prețurile tale prin API
Trimiți prețurile tale (unul câte unul sau în lot, până la 2.000), fără scraping și fără credite, și citești comparația pe grup și prețul recomandat. O recomandare nu se aplică singură: ajunge la tine printr-un webhook după aprobare.
Vânzările tale, baza sumelor în bani
POST /sales/bulk primește vânzările zilnice per produs (până la 2.000 de rânduri, idempotent pe produs și zi). Din ele se calculează valoarea estimată a oportunităților; fără vânzări, valoarea rămâne „—”, nu o cifră inventată.
Oportunități și briefing
GET /insights/ (constatări cu dovezi și propuneri de preț), GET /opportunities/ (sumar: valoarea din vânzări, separat de estimarea de piață) și GET /briefings/latest (briefingul zilnic).
Acțiuni de preț și confirmare
GET /actions/ listează acțiunile (propuse, trimise, aplicate, revenite). După ce sistemul tău aplică un preț primit prin price.apply, POST /actions/{id}/confirm trece acțiunea în „aplicată”.
Webhook semnat, cu evenimente
Un URL pe cont, cu semnătură HMAC-SHA256 în antetul X-4Pricing-Signature (sha256=<HMAC al „<timestamp>.<corp>”>, plus X-4Pricing-Timestamp) și reîncercări cu backoff. Evenimente: alerte, price.apply, price.revert și briefing.ready; nu este un flux general de modificări de preț.
Ce oferă API-ul și webhook-ul 4pricing
| Funcție | Ce primești |
|---|---|
| API REST | Autentificare cu X-API-Key, 60 de cereri pe minut per cont, specificație OpenAPI |
| Citiri | Lista de produse, istoric și comparații, fără consum de credite |
| Prețurile tale | Trimitere individuală sau în lot (până la 2.000), fără credite |
| Vânzările tale | POST /sales/bulk, până la 2.000 de rânduri, idempotent pe produs și zi |
| Oportunități și briefing | GET /insights/, GET /opportunities/, GET /briefings/latest |
| Acțiuni de preț | GET /actions/ și POST /actions/{id}/confirm după aplicarea unui price.apply |
| Credite | Doar când se citește o pagină de magazin |
| Webhook | POST semnat HMAC-SHA256 (X-4Pricing-Signature, X-4Pricing-Timestamp), un URL pe cont, reîncercări cu backoff; evenimente: alerte, price.apply, price.revert, briefing.ready |
Generezi o cheie API din panou și o trimiți în antetul X-API-Key. Citești produsele, istoricul, comparațiile, oportunitățile și briefingul (în limita de 60 de cereri pe minut) și îți trimiți propriile prețuri și vânzările zilnice. Pentru evenimente, înregistrezi URL-ul de webhook și verifici semnătura fiecărui POST; la un price.apply aplici prețul în sistemul tău și apelezi POST /actions/{id}/confirm.
Întrebări frecvente despre API și webhooks
Construiește peste datele de preț 4pricing
API REST pentru produse, istoric, oportunități și briefing, plus webhook semnat pentru alerte și prețuri aprobate — cu specificație OpenAPI.