API δεδομένων τιμών — πρόσβαση στα δεδομένα παρακολούθησης από τα δικά σας συστήματα
Το REST API του 4pricing.net επιτρέπει στην τεχνική σας ομάδα να αντλεί τα δεδομένα παρακολούθησης τιμών στα δικά της συστήματα (για παράδειγμα ERP, WMS ή ηλεκτρονικό κατάστημα). Το 4pricing δεν προσφέρει έτοιμους συνδέσμους (connectors)· τη σύνδεση τη χτίζει ο προγραμματιστής σας πάνω στο API. Η ταυτοποίηση γίνεται με κλειδί API, οι αποκρίσεις είναι τυπικό JSON και η προδιαγραφή δημοσιεύεται ως OpenAPI 3.0, έτοιμη για εισαγωγή στον client σας.
Βασικά endpoints
Το API εκθέτει τα δεδομένα παρακολούθησης σε επίπεδο παρακολουθούμενου προϊόντος: τη λίστα προϊόντων με την τρέχουσα τιμή τους, το ιστορικό τιμών ενός προϊόντος και ένα μαζικό μίνι ιστορικό για προβολές λίστας. Τα προϊόντα ταυτοποιούνται με το product_id που επιστρέφεται κατά την προσθήκη τους — αυτό είναι το κλειδί διαδρομής. Τα ποσά δίνονται σε υποδιαιρέσεις, στα πεδία current_price_cents και price_cents, μαζί με το νόμισμα, ενώ κάθε εγγραφή φέρει την ακριβή ώρα του ελέγχου (last_scraped_at και scraped_at αντίστοιχα).
- GET /products/ — τα παρακολουθούμενα προϊόντα σας, με τρέχουσα τιμή και νόμισμα
- GET /products/{product_id}/history — το ιστορικό τιμών ενός προϊόντος, με χρονοσημάνσεις
- GET /products/sparklines — μαζικό μίνι ιστορικό, μία σειρά τιμών ανά προϊόν
- POST /alerts/ — δημιουργία ειδοποίησης (κατώφλι, ποσοστιαία πτώση, απόθεμα, ανταγωνιστής)
Ταυτοποίηση και όριο συχνότητας
Η ταυτοποίηση γίνεται με την κεφαλίδα X-API-Key ή, ισοδύναμα, με Authorization: Bearer και το ίδιο κλειδί. Τα κλειδιά δημιουργούνται από τον πίνακα ελέγχου, στην ενότητα API & κλειδιά, και η πλήρης τιμή εμφανίζεται μόνο μία φορά, κατά τη δημιουργία. Το όριο είναι 60 αιτήματα ανά λεπτό ανά λογαριασμό, κοινό για όλα τα κλειδιά σας· πάνω από αυτό το API απαντά 429 και στέλνει την κεφαλίδα Retry-After.
Πλεονεκτήματα και περιορισμοί
Πλεονεκτήματα
- Η ομάδα σας μπορεί να τροφοδοτεί το δικό της ERP/WMS απευθείας από το API, χωρίς χειροκίνητη εξαγωγή CSV (τον σύνδεσμο τον χτίζετε εσείς)
- Οι ειδοποιήσεις μπορούν να παραδίδονται με webhook, χωρίς να χρειάζεται polling
- Δημοσιευμένη προδιαγραφή OpenAPI 3.0 που εισάγετε απευθείας στον client σας
- Πρόσβαση στη συνιστώμενη τιμή για την ομάδα σύγκρισης, όχι μόνο σε ακατέργαστα δεδομένα
Περιορισμοί
- Το όριο των 60 αιτημάτων/λεπτό ανά λογαριασμό (κοινό για όλα τα κλειδιά) απαιτεί μαζικές αναγνώσεις και τοπική προσωρινή αποθήκευση σε μεγάλους καταλόγους
- Το webhook απαιτεί δημόσιο URL http/https (θύρα 80/443) στη δική σας υποδομή
Σύντομο συμπέρασμα
Το API καλύπτει την ανάγνωση των δεδομένων παρακολούθησης και της συνιστώμενης τιμής, την αποστολή των δικών σας τιμών και την εφαρμογή της συνιστώμενης τιμής, αλλά δεν συνοδεύεται από συνδέσμους για ERP ή κατάστημα. Μεγάλοι κατάλογοι ωφελούνται από μαζική ανάγνωση (σελιδοποίηση, μαζικό μίνι ιστορικό) και τοπική προσωρινή αποθήκευση.
Πίνακας προδιαγραφών
| Endpoint | Μέθοδος | Απόκριση |
|---|---|---|
| /products/ | GET | Πίνακας JSON με τα παρακολουθούμενα προϊόντα, με current_price_cents |
| /products/{product_id}/history | GET | Πίνακας JSON με το ιστορικό και χρονοσημάνσεις |
| /products/sparklines | GET | JSON με μία σειρά τιμών ανά προϊόν |
| /alerts/ | POST | Η ειδοποίηση που δημιουργήθηκε, με τύπο και κατώφλι |
API έναντι εξαγωγής CSV κατά παραγγελία
| Κριτήριο | REST API | Εξαγωγή CSV |
|---|---|---|
| Καθυστέρηση δεδομένων | Τα δεδομένα είναι τόσο πρόσφατα όσο ο τελευταίος έλεγχος | Δεδομένα της στιγμής που κατεβάζετε το αρχείο |
| Σύνδεση με ERP | Μέσω HTTP, με σύνδεσμο που γράφει η ομάδα σας | Χειροκίνητη εισαγωγή ή μέσω cron |
| Ειδοποιήσεις push | Ναι (webhook) | Όχι |
Συχνές ερωτήσεις
Πώς αποκτώ κλειδί API;
Δημιουργείτε το κλειδί από τον πίνακα του λογαριασμού σας στο 4pricing.net, στην ενότητα API & κλειδιά. Η πλήρης τιμή του κλειδιού εμφανίζεται μόνο μία φορά, κατά τη δημιουργία — αν τη χάσετε, ανακαλέστε το κλειδί και δημιουργήστε νέο.
Μπορώ να έχω πρόσβαση στα δεδομένα όλων των προϊόντων ταυτόχρονα;
Ναι, το GET /products/?skip=0&limit=200 σάς επιτρέπει να διατρέξετε σελίδα προς σελίδα ολόκληρο τον παρακολουθούμενο κατάλογο· ο συνολικός αριθμός εγγραφών επιστρέφεται στην κεφαλίδα X-Total-Count. Για μεγάλες λίστες, το GET /products/sparklines επιστρέφει το μίνι ιστορικό πολλών προϊόντων σε μία κλήση. Συνιστούμε νυχτερινό συγχρονισμό για μεγάλους καταλόγους και συχνότερες αναγνώσεις μόνο για τα προϊόντα που σας ενδιαφέρουν.
Σε ποια μορφή επιστρέφει το API το ιστορικό τιμών;
Ως πίνακα JSON με αντικείμενα {product_id, price_cents, currency, in_stock, scraped_at}, ταξινομημένα κατά φθίνουσα ημερομηνία. Η τιμή δίνεται σε υποδιαιρέσεις (price_cents), όχι σε ακέραιες μονάδες νομίσματος, και το scraped_at είναι ακριβής χρονοσήμανση ISO 8601.
Ποια γεγονότα στέλνει το webhook;
Υπάρχει ένα URL webhook ανά λογαριασμό, και λαμβάνει κάθε τύπο ειδοποίησης που δημιουργείτε: τιμή κάτω από όριο, τιμή πάνω από όριο, ποσοστιαία πτώση, επιστροφή σε απόθεμα, ανταγωνιστή που σας υποτιμολογεί και απώλεια της θέσης χαμηλότερης τιμής. Δεν υπάρχει ειδοποίηση για το κατώφλι κόστους ως τέτοιο.