PrestaShop Webservice: filters, sorting και pagination χωρίς να κατεβάζεις όλο το catalogue

Το /api/products δουλεύει.

Το επόμενο λάθος είναι να ζητήσεις όλο το catalogue, με όλα τα fields, σε κάθε request.

Σε μικρό shop μπορεί να μη φανεί. Σε catalogue με χιλιάδες προϊόντα όμως, το σωστό filtering και pagination γίνεται μέρος του integration design.

1. Μην ξεκινάς με display=full

Για ένα synchronization ίσως χρειάζεσαι μόνο:

id
reference
price
active
date_upd

Άρα:

/api/products?display=[id,reference,price,active,date_upd]

Το dataset γίνεται μικρότερο και πιο ξεκάθαρο.

2. Filter by reference

/api/products?filter[reference]=[ABC-001]

Useful flow:

EXTERNAL SKU
    ↓
filter[reference]
    ↓
PrestaShop Product ID

3. Sorting

Για deterministic exports:

/api/products?display=[id,reference,date_upd]&sort=[id_ASC]

ή:

sort=[date_upd_DESC]

4. Limit

limit=100

ή:

limit=0,100

5. Pagination

Παράδειγμα:

0,100
100,100
200,100
300,100

REQUEST 1 → rows 0–99
REQUEST 2 → rows 100–199
REQUEST 3 → rows 200–299

6. Batch processing

FETCH
  ↓
VALIDATE
  ↓
TRANSFORM
  ↓
SAVE / SYNC
  ↓
NEXT OFFSET

Μην περιμένεις να ολοκληρωθεί όλο το catalogue πριν αποθηκεύσεις progress.

7. Incremental sync

Πιο χρήσιμο από συνεχές full export:

LAST SUCCESSFUL SYNC
        ↓
date_upd
        ↓
ONLY CHANGED PRODUCTS
        ↓
UPDATE TARGET

8. Τι να καταγράφεις

request URL
offset
limit
HTTP status
records returned
started_at
completed_at

9. Empty response δεν σημαίνει πάντα error

Μπορεί:

• να τελείωσε το pagination,
• να μην υπάρχουν matches,
• να υπάρχει λάθος filter,
• να βρίσκεσαι σε διαφορετικό shop context.

Production pattern

CONFIG
  ↓
FILTER
  ↓
SELECT FIELDS
  ↓
SORT
  ↓
PAGINATE
  ↓
TRANSFORM
  ↓
STORE
  ↓
VERIFY

[SCREENSHOT PLACEHOLDER 01]

Postman request με display, filter, sort και limit.

[SCREENSHOT PLACEHOLDER 02]

Δύο paginated responses με διαφορετικό offset.

Το API δεν είναι export button

Το σημαντικό δεν είναι απλώς να πάρεις data.

Είναι να ζητήσεις μόνο όσα χρειάζεσαι, deterministic και σε batches που μπορείς να ελέγξεις.

Επόμενο βήμα

Βάλε το paginated read σε ένα Google Sheets reporting workflow, κρατώντας offsets και sync metadata για κάθε batch. Αν το request δεν είναι ακόμη ξεκάθαρο, γύρισε στον οδηγό για το πρώτο Webservice request πριν το αυτοματοποιήσεις.