Sync API: τα βασικά

Ενημερώθηκε 11 Ιουλίου 2026Διαθέσιμο από το πλάνο Starter

Αν προτιμάς το περιεχόμενο να αποθηκεύεται μέσα στο eshop σου (αντί να σερβίρεται από το widget), ο developer σου το τραβά με το Sync API — ένα απλό REST API με ροή δύο βημάτων.

Η λογική: pending → confirm

Κάθε προϊόν, κατηγορία και μάρκα έχει μια κατάσταση συγχρονισμού με δύο μόνο τιμές:

  • pending_sync — υπάρχει εγκεκριμένη αλλαγή που δεν έχει τραβηχτεί ακόμα.
  • synced — το eshop έχει την τελευταία έκδοση.

Κάθε νέα έγκριση ξαναγυρνά το στοιχείο σε pending_sync. Η ροή του developer:

  1. Τράβα τα εκκρεμή: GET /api/v1/sync/products/pending — επιστρέφει μόνο ό,τι άλλαξε.
  2. Αποθήκευσε τα δεδομένα στη βάση του eshop.
  3. Επιβεβαίωσε: POST /api/v1/sync/products/confirm με τα IDs που αποθηκεύτηκαν — μαρκάρονται synced.

Η ίδια ροή ισχύει για categories και brands. Το GET /api/v1/sync/status δίνει συνολική εικόνα (πόσα εκκρεμούν ανά τύπο).

Authentication

Όλα τα αιτήματα θέλουν API key ως Bearer token:

curl -H "Authorization: Bearer ac_xxxxxxxx" \
  https://aironflow.io/api/v1/sync/products/pending

Τα κλειδιά (πρόθεμα ac_) δημιουργούνται από τις ρυθμίσεις του λογαριασμού. Όριο: 100 αιτήματα/λεπτό.

Το API key δίνει πρόσβαση στα δεδομένα του eshop σου — φύλαξέ το σαν κωδικό. Αν διαρρεύσει, ανακάλεσέ το και δημιούργησε νέο.

Ειδοποίηση όταν υπάρχουν νέα δεδομένα

Αντί για polling, μπορείς να δηλώσεις webhook: όταν ολοκληρώνεται συγχρονισμός με νέο περιεχόμενο, το AironFlow καλεί το URL σου (data_ready) και τότε τραβάς τα pending.

Το πλήρες reference με όλα τα endpoints, παραμέτρους και παραδείγματα: Integration Guide. Έτοιμη Postman collection κατεβαίνει από τη σελίδα ενσωμάτωσης του λογαριασμού σου.

Ήταν χρήσιμο αυτό το άρθρο;

Προηγούμενο
Ενσωμάτωση του widget στο eshop σου

Σχετικά άρθρα