Skip to content
Syncore

Ξεκίνημα

Το Syncore API είναι ένα REST API με JSON για τους πελάτες του Syncore. Με αυτό διαβάζεις και αλλάζεις προϊόντα, τιμές, απόθεμα και παραγγελίες της επιχείρησής σου, διαβάζεις παραστατικά και λαμβάνεις webhooks όταν κάτι αλλάζει.

Κάθε token ανήκει σε έναν χρήστη και βλέπει μόνο τα δεδομένα της δικής του επιχείρησης. Η επιχείρηση προκύπτει πάντα από το token, ποτέ από το αίτημα.

Τι χρειάζεσαι

  • Λογαριασμό Syncore με ενεργή συνδρομή (χωρίς συνδρομή το API απαντά 402).
  • Χρήστη επιχείρησης (διαχειριστή ή χρήστη του καταστήματος). Tokens διαχειριστών πλατφόρμας ή μεταπωλητών δεν δουλεύουν στο API πελατών.

1. Δημιούργησε token

  1. Συνδέσου στο Syncore και άνοιξε Προφίλ → API tokens.
  2. Δώσε όνομα (π.χ. «ERP σύνδεση») και διάλεξε τα δικαιώματα (abilities) που χρειάζεται η εφαρμογή σου — μόνο αυτά.
  3. Προαιρετικά: ημερομηνία λήξης και δικό του όριο αιτημάτων ανά λεπτό.
  4. Πάτησε δημιουργία και αντίγραψε το token αμέσως. Εμφανίζεται μόνο μία φορά· αν χαθεί, φτιάξε νέο και ανακάλεσε το παλιό.

Αναλυτικά για τα δικαιώματα και τα όρια: Αυθεντικοποίηση & όρια.

Κράτα το token σαν κωδικό: σε μεταβλητή περιβάλλοντος ή secret manager, ποτέ σε κώδικα του browser ή σε δημόσιο repository.

2. Βασική διεύθυνση

https://app.syncore.gr/api/v1

Όλα τα αιτήματα στέλνουν το token στο header Authorization και δέχονται JSON:

Authorization: Bearer <TOKEN>
Accept: application/json
Content-Type: application/json

3. Πρώτο αίτημα

Με το token σε μεταβλητή περιβάλλοντος:

export SYNCORE_TOKEN="<TOKEN>"

curl -s "https://app.syncore.gr/api/v1/products?per_page=2" \
  -H "Authorization: Bearer $SYNCORE_TOKEN" \
  -H "Accept: application/json"

Απάντηση (συντομευμένη):

{
  "data": [
    {
      "id": 1201,
      "sku": "ABC-1001",
      "ean": "5200000000001",
      "name": "Παράδειγμα προϊόντος",
      "brand": "Brand",
      "supplier": { "id": 7, "name": "Προμηθευτής Α" },
      "base_price": 12.4,
      "final_price": 19.9,
      "manual_price": false,
      "enabled": true,
      "supplier_stock": 35,
      "variant_count": 0,
      "updated_at": "2026-10-29T10:00:00+02:00"
    }
  ],
  "meta": { "current_page": 1, "per_page": 2, "total": 340, "last_page": 170 },
  "links": { "next": "https://app.syncore.gr/api/v1/products?page=2", "prev": null }
}

Σελιδοποίηση

Οι λίστες δέχονται page και per_page (προεπιλογή 25, μέγιστο 100) και επιστρέφουν meta (current_page, per_page, total, last_page) και links (next, prev). Ακολούθησε το links.next μέχρι να γίνει null.

Επόμενα βήματα