Το blog για τις ανανεώσιμες πηγές ενέργειας

Πώς να αποκτήσετε πρόσβαση στα δεδομένα του inverter Heiwit σας μέσω API (Data Act)

Οκτ 5, 2026 | AI-Care, Οδηγοί, Βίντεο

Πώς να αποκτήσετε πρόσβαση στα δεδομένα του inverter Heiwit σας μέσω API

Μπορείτε να διαβάζετε τα δεδομένα της εγκατάστασης Heiwit σας και από ένα εξωτερικό πρόγραμμα, μέσω API. Συνδέεστε στο AI-Care, ανοίγετε Report › Scarica i dati del tuo impianto (Λήψη δεδομένων της εγκατάστασής σας) › Accesso via API (Πρόσβαση μέσω API) και δημιουργείτε ένα token: είναι το κλειδί που χρησιμοποιεί το πρόγραμμα για να ζητά τα δεδομένα. Η πρόσβαση είναι δωρεάν, μόνο για ανάγνωση, και κάθε token ισχύει για μία μόνο εγκατάσταση. Είναι η διαδικασία που παρέχει η Heiwit για την άσκηση του δικαιώματος πρόσβασης στα δεδομένα που προβλέπει το ευρωπαϊκό Data Act (Κανονισμός (ΕΕ) 2023/2854).

Στο βίντεο βλέπετε ολόκληρη τη διαδικασία: ενεργοποίηση της πρόσβασης, έλεγχο ταυτότητας με το token και πρώτο αίτημα. Παρακάτω θα τη βρείτε εξηγημένη βήμα προς βήμα, με τη λίστα των διαθέσιμων δεδομένων, τα όρια και μερικά έτοιμα παραδείγματα για αντιγραφή.

Πρώτα απ' όλα: χρειάζεστε πραγματικά το API;

Αν θέλετε μόνο τους αριθμούς σε ένα φύλλο Excel, όχι. Στη σελίδα Report του AI-Care υπάρχει το πλαίσιο Scarica i dati del tuo impianto: επιλέγετε την περίοδο και την ανάλυση (ανά ώρα, ανά ημέρα ή ανά μήνα) και κατεβάζετε ένα αρχείο Excel ή CSV. Δεν χρειάζεται καμία ρύθμιση.

Το API χρησιμεύει όταν θέλετε τα δεδομένα να φτάνουν αυτόματα σε ένα άλλο πρόγραμμα, χωρίς να κατεβάζετε αρχεία χειροκίνητα. Για παράδειγμα:

  • ένα σύστημα οικιακού αυτοματισμού όπως το Home Assistant;
  • ένα φύλλο Excel που ενημερώνεται με ένα κλικ·
  • το λογισμικό διαχείρισης μιας επιχείρησης, το λογισμικό ενός ενεργειακού συμβούλου ή μιας ενεργειακής κοινότητας·
  • ένα script γραμμένο από εσάς ή από τον τεχνικό σας.

Τι είναι ένα API, με απλά λόγια

Ένα API είναι μια διεύθυνση web σχεδιασμένη για προγράμματα και όχι για ανθρώπους. Εσείς ανοίγετε μια σελίδα και τη διαβάζετε· ένα πρόγραμμα «καλεί» τη διεύθυνση και λαμβάνει τα δεδομένα σε οργανωμένη μορφή, έτοιμα για χρήση: JSON ή CSV.

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

Το δικαίωμα στα δεδομένα σας: το Data Act

Το Data Act είναι ο ευρωπαϊκός κανονισμός για τα δεδομένα (Κανονισμός (ΕΕ) 2023/2854) και εφαρμόζεται από τις 12 Σεπτεμβρίου 2025. Αφορά και τα συνδεδεμένα προϊόντα, όπως ο inverter με την υπηρεσία παρακολούθησής του, και δίνει σε όποιον τα χρησιμοποιεί δύο δικαιώματα:

  • να έχει πρόσβαση στα δεδομένα που παράγονται από τη χρήση του προϊόντος και να τα χρησιμοποιεί (άρθρο 4)·
  • να τα θέτει στη διάθεση τρίτου που έχει ορίσει ο ίδιος, για παράδειγμα του εγκαταστάτη ή ενός συμβούλου (άρθρο 5).

Γι' αυτό η πρόσβαση στα δεδομένα που σας ανήκουν είναι δωρεάν. Πρώτα η Heiwit επαληθεύει ότι έχετε το δικαίωμα: γι' αυτό το token δημιουργείται μόνο αφού συνδεθείτε στο AI-Care με τον λογαριασμό στον οποίο είναι συνδεδεμένη η εγκατάσταση.

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

  • Τον λογαριασμό της πύλης Heiwit. Το AI-Care χρησιμοποιεί τα ίδια διαπιστευτήρια με την πύλη: email ή όνομα χρήστη και κωδικό πρόσβασης. Αν δεν θυμάστε τον κωδικό, χρησιμοποιήστε την επιλογή Ανάκτηση κωδικού πρόσβασης στη σελίδα σύνδεσης.
  • Την εγκατάσταση συνδεδεμένη με τον λογαριασμό σας. Αν συνδεθείτε και δεν βλέπετε την εγκατάστασή σας, ζητήστε την ενεργοποίηση από την υποστήριξη.
  • Ένα πρόγραμμα που μπορεί να κάνει αιτήματα web: Home Assistant, Excel, Python, την εντολή curl ή το λογισμικό του προμηθευτή σας.

Βήμα 1: δημιουργήστε το token

  1. Μεταβείτε στο ai-care.heiwit.com και συνδεθείτε.
  2. Αν έχετε περισσότερες εγκαταστάσεις, επιλέξτε αυτή που σας ενδιαφέρει.
  3. Ανοίξτε τις Report από το μενού.
  4. Στο κάτω μέρος της σελίδας ανοίξτε το πλαίσιο Scarica i dati del tuo impianto και στη συνέχεια την ενότητα Accesso via API.
  5. Γράψτε ένα όνομα που να σας θυμίζει σε τι χρησιμεύει το token, για παράδειγμα «Home Assistant», και πατήστε Crea token.
  6. Αντιγράψτε αμέσως το token και φυλάξτε το σε ασφαλές μέρος: εμφανίζεται μόνο μία φορά. Το αναγνωρίζετε επειδή ξεκινά με aic_.

Στην ίδια ενότητα βρίσκετε τη λίστα των ενεργών token της εγκατάστασης, με την τελευταία χρήση, τον αριθμό κλήσεων και την ημερομηνία απενεργοποίησής τους. Με την επιλογή Revoca απενεργοποιείτε ένα token αμέσως.

Βήμα 2: κάντε το πρώτο αίτημα

Όλα τα αιτήματα ξεκινούν από αυτή τη διεύθυνση:

https://ai-care.heiwit.com/api/v1

Το token αποστέλλεται σε μια κεφαλίδα (header) του αιτήματος με όνομα Authorization, με προπορευόμενη τη λέξη Bearer και ένα κενό:

Authorization: Bearer aic_IL_TUO_TOKEN

Για μια γρήγορη δοκιμή αρκεί το τερματικό με την εντολή curl, που υπάρχει ήδη σε Windows 10 και 11, macOS και Linux. Αντικαταστήστε το aic_IL_TUO_TOKEN με το token σας:

curl -H "Authorization: Bearer aic_IL_TUO_TOKEN" "https://ai-care.heiwit.com/api/v1/status"

Στα Windows, στο PowerShell, γράψτε curl.exe αντί για curl.

Δεν χρειάζεται να ορίσετε ποια εγκατάσταση θα διαβαστεί: το καθορίζει το token. Η απάντηση μοιάζει με αυτή:

{
  "plant": {
    "sn": "90xxxxxxxxxxxxxxxx",
    "name": "Casa",
    "model": "Virgo6K-S-HW",
    "installed_power_kwp": 6,
    "battery_capacity_kwh": 10
  },
  "updated_at": "2026-10-05 07:10:12",
  "now": {
    "pv_w": 3120,
    "battery_w": -1450,
    "grid_w": 0,
    "load_w": 1670,
    "battery_soc": 64,
    "battery_soh": 100,
    "work_mode": 1,
    "work_mode_label": "Self-use (autoconsumo)"
  },
  "lifetime_kwh": {
    "pv": 8421.5,
    "export": 2310.2,
    "import": 1187.4,
    "bat_charge": 2950.8,
    "bat_discharge": 2702.3
  }
}

Σε αυτό το παράδειγμα τα πάνελ παράγουν 3.120 W: 1.670 W πηγαίνουν στο σπίτι και 1.450 W φορτίζουν την μπαταρία, η οποία βρίσκεται στο 64%. Με το δίκτυο δεν γίνεται καμία ανταλλαγή.

Τι μπορείτε να διαβάσετε

Το API έχει τρεις διευθύνσεις, όλες μόνο για ανάγνωση (αιτήματα GET):

ΔιεύθυνσηΣε τι χρησιμεύει
/statusΗ εικόνα της εγκατάστασης: ισχύς πάνελ, μπαταρίας, δικτύου και σπιτιού αυτή τη στιγμή, φόρτιση και υγεία της μπαταρίας, τρόπος λειτουργίας, σύνολα από την εγκατάσταση.
/energyΤο ιστορικό ενέργειας ανά ώρα, ανά ημέρα ή ανά μήνα, με ιδιοκατανάλωση, αυτονομία και τιμές σε ευρώ. Σε JSON ή CSV.
/tokenΟι πληροφορίες για το token σε χρήση: πότε απενεργοποιείται και πόσες κλήσεις έχετε κάνει σήμερα.

/status: η εγκατάσταση τώρα

ΠεδίοΤι περιέχει
plantΣειριακός αριθμός, όνομα και μοντέλο του inverter, ισχύς των πάνελ (kWp), χωρητικότητα της μπαταρίας (kWh).
updated_atΗμερομηνία και ώρα της τελευταίας μέτρησης, σε ώρα UTC: για την ώρα Ιταλίας προσθέστε 2 ώρες το καλοκαίρι και 1 τον χειμώνα. Αν είναι κενό (null), το σύστημα δεν στέλνει μετρήσεις εδώ και λίγη ώρα και οι τιμές ισχύος είναι 0: δεν πρέπει να διαβάζονται ως μετρήσεις.
now.pv_wΙσχύς που παράγεται από τα πάνελ, σε watt.
now.battery_wΙσχύς της μπαταρίας: θετική όταν εκφορτίζεται, αρνητική όταν φορτίζεται.
now.grid_wΙσχύς που ανταλλάσσεται με το δίκτυο: θετική όταν εγχέετε, αρνητική όταν απορροφάτε.
now.load_wΙσχύς που καταναλώνει το σπίτι.
now.battery_socΦόρτιση της μπαταρίας, σε %.
now.battery_sohΚατάσταση υγείας της μπαταρίας, σε %.
now.work_modeΤρόπος λειτουργίας του inverter (για παράδειγμα ιδιοκατανάλωση ή backup), με την περιγραφή στο work_mode_label.
lifetime_kwhΣύνολα από την εγκατάσταση, σε kWh: ενέργεια που παρήχθη (pv), εγχύθηκε (export), απορροφήθηκε (import), φορτίστηκε στην μπαταρία (bat_charge) και εκφορτίστηκε (bat_discharge).

/energy: το ιστορικό

Παράδειγμα: τα δεδομένα ανά ημέρα για τον Σεπτέμβριο 2026, μόνο ενέργεια και ιδιοκατανάλωση.

curl -H "Authorization: Bearer aic_IL_TUO_TOKEN" "https://ai-care.heiwit.com/api/v1/energy?granularity=day&from=2026-09-01&to=2026-09-30&fields=energy,derived"

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

ΠαράμετροςΕπιτρεπόμενες τιμέςΑν δεν την ορίσετε
granularityhour (ανά ώρα), day (ανά ημέρα), month (ανά μήνα)day
from, toΗμερομηνίες σε μορφή ΕΕΕΕ-ΜΜ-ΗΗ, για παράδειγμα 2026-09-01Οι τελευταίες 30 ημέρες, συμπεριλαμβανομένης της σημερινής
fieldsΜία ή περισσότερες ομάδες δεδομένων χωρισμένες με κόμμα (δείτε τον πίνακα παρακάτω)energy,derived,economics
formatcsv για να λάβετε αρχείο CSV αντί για JSONJSON

Με granularity=hour ένα αίτημα καλύπτει το πολύ 400 ημέρες: για μεγαλύτερες περιόδους κάντε περισσότερα αιτήματα. Με day και month μπορείτε να ζητήσετε όλο το ιστορικό με μία μόνο κλήση.

Το CSV χρησιμοποιεί το κόμμα ως διαχωριστικό και την τελεία για τα δεκαδικά, τη συνηθέστερη μορφή για τα προγράμματα. Για να το ανοίξετε με Excel σε ελληνικές ρυθμίσεις προσθέστε &delimiter=semicolon&decimal=comma.

Οι ομάδες δεδομένων που μπορείτε να ζητήσετε με fields:

ΟμάδαΠεδίαΤι περιέχει
energy
(περιλαμβάνεται πάντα)
pv_kwh, export_kwh, import_kwh, bat_charge_kwh, bat_discharge_kwhΕνέργεια που παρήχθη από τα πάνελ, εγχύθηκε στο δίκτυο, απορροφήθηκε από το δίκτυο, φορτίστηκε στην μπαταρία και εκφορτίστηκε από την μπαταρία.
derivedself_consumption_kwh, home_load_kwh, autonomy_pct, pv_self_used_pctΙδιοκατανάλωση (ενέργεια που χρησιμοποιήθηκε στο σπίτι χωρίς απορρόφηση από το δίκτυο, συμπεριλαμβανομένης της μπαταρίας), κατανάλωση του σπιτιού, αυτονομία (ποσοστό της κατανάλωσης που καλύπτεται από το σύστημα), ποσοστό της παραγωγής που χρησιμοποιήθηκε στο σπίτι.
economicspun_eur_mwh, buy_price_eur_kwh, sell_price_eur_kwh, import_cost_eur, export_revenue_eur, self_consumption_saving_eur, total_benefit_eurΧονδρική τιμή ενέργειας (PUN), εκτιμώμενες τιμές αγοράς και πώλησης, κόστος απορρόφησης, έσοδα από την έγχυση, εξοικονόμηση λόγω ιδιοκατανάλωσης, συνολικό όφελος (εξοικονόμηση συν έσοδα).
stringspv1_kwh, pv2_kwhΞεχωριστή παραγωγή των δύο στοιχειοσειρών πάνελ.
rawself_use_kwh, self_give_kwhΑκατέργαστοι μετρητές, όπως τους καταγράφει ο inverter.

Κάθε γραμμή ξεκινά με την ημερομηνία (date), στην οποία προστίθεται η ώρα (hour) στην ωριαία ανάλυση· στη μηνιαία ανάλυση υπάρχει ο μήνας (month). Η απάντηση JSON του παραδείγματος έχει την εξής μορφή:

{
  "plant": { "sn": "90xxxxxxxxxxxxxxxx" },
  "granularity": "day",
  "from": "2026-09-01",
  "to": "2026-09-30",
  "fields": ["energy", "derived"],
  "count": 30,
  "truncated": false,
  "generated_at": "2026-10-05T09:30:00+02:00",
  "data": [
    {
      "date": "2026-09-01",
      "pv_kwh": 31.4,
      "export_kwh": 9.8,
      "import_kwh": 1.2,
      "bat_charge_kwh": 8.7,
      "bat_discharge_kwh": 7.9,
      "self_consumption_kwh": 20.8,
      "home_load_kwh": 22.0,
      "autonomy_pct": 94.5,
      "pv_self_used_pct": 68.8
    }
  ]
}

Εδώ εμφανίζονται μόνο οι πρώτες γραμμές: στο data υπάρχουν και οι 30 ημέρες (count).

/token: η κατάσταση του token

Επιστρέφει το όνομα του token, το σύστημα, την ημερομηνία δημιουργίας, την τελευταία χρήση, την ημερομηνία κατά την οποία θα απενεργοποιηθεί αν δεν το χρησιμοποιήσετε (expires_at), τις κλήσεις που έγιναν σήμερα και τα όρια. Είναι χρήσιμο για να ελέγξετε ότι όλα λειτουργούν. Και αυτή η κλήση μετρά στο ημερήσιο όριο.

Πόσο ενημερωμένα είναι τα δεδομένα

  • Τρέχουσα κατάσταση (/status): ο inverter στέλνει μια μέτρηση περίπου κάθε 5 λεπτά και το API επιστρέφει την τελευταία που έφτασε. Δεν ρωτά τον inverter σε πραγματικό χρόνο: διαβάζει τα δεδομένα που έχει ήδη συλλέξει η παρακολούθηση, οπότε οι κλήσεις σας δεν επιβαρύνουν το σύστημα.
  • Ιστορικό (/energy): η τρέχουσα ώρα και ημέρα είναι μερικές και αυξάνονται σταδιακά. Οι ημερομηνίες και οι ώρες είναι σε ώρα Ιταλίας.
  • Αν ο inverter χάσει τη σύνδεση στο διαδίκτυο, το API απαντά ούτως ή άλλως με την τελευταία μέτρηση που έφτασε: δείτε το updated_at για να καταλάβετε πόσο πρόσφατη είναι.
  • Οι τιμές σε ευρώ είναι εκτιμήσεις, υπολογισμένες με τη χονδρική τιμή ενέργειας (PUN) της περιόδου και με τον ίδιο τύπο που χρησιμοποιούν τα πλαίσια του AI-Care. Δεν αντιστοιχούν στον λογαριασμό σας.

Κανόνες και όρια του token

  • Ένα token, ένα σύστημα. Αν έχετε περισσότερα συστήματα, δημιουργείτε ένα token για το καθένα.
  • Μόνο ανάγνωση. Με το token δεν μπορεί να αλλάξει τίποτα.
  • Έως 5 ενεργά token ανά εγκατάσταση. Συνιστάται να χρησιμοποιείτε ένα για κάθε πρόγραμμα: αν χρειαστεί να απενεργοποιήσετε ένα, τα υπόλοιπα συνεχίζουν να λειτουργούν.
  • 10 κλήσεις ανά λεπτό και 300 ανά ημέρα για κάθε token. Η ημερήσια καταμέτρηση μηδενίζεται τα μεσάνυχτα, ώρα Ιταλίας. Κάθε απόκριση αναφέρει το ημερήσιο όριο στην κεφαλίδα X-Quota-Limit και τις κλήσεις που απομένουν για σήμερα στην X-Quota-Remaining.
  • Χωρίς σταθερή λήξη. Το token απενεργοποιείται αυτόματα αν μείνει αχρησιμοποίητο για 60 ημέρες· κάθε κλήση μεταθέτει τη λήξη προς τα εμπρός.
  • Άμεση ανάκληση. Με Revoca, στη σελίδα Report, το token σταματά αμέσως να λειτουργεί.

Κάθε πότε να ζητάτε τα δεδομένα; Η κατάσταση αλλάζει περίπου κάθε 5 λεπτά, επομένως οι συχνότερες κλήσεις δεν δίνουν νέα δεδομένα. Μία κλήση κάθε 5 λεπτά σημαίνει 288 κλήσεις την ημέρα: είναι εντός ορίου, αλλά αφήνει ελεύθερες μόνο 12. Αν χρειάζεστε το ίδιο token και για άλλη χρήση, επιλέξτε μία κλήση κάθε 10 λεπτά. Για το ιστορικό αρκεί μία κλήση την ημέρα.

Αν κάτι δεν λειτουργεί

Όταν ένα αίτημα αποτυγχάνει, το API απαντά με έναν κωδικό, ένα σύντομο αναγνωριστικό (error) και ένα μήνυμα στα ιταλικά που εξηγεί τι πρέπει να διορθωθεί. Για παράδειγμα:

{ "error": "invalid_token", "message": "Token non valido o revocato." }
ΑπόκρισηΤι σημαίνειΤι να κάνετε
401 missing_bearerΛείπει η κεφαλίδα Authorization, ή είναι γραμμένη λάθος.Ελέγξτε ότι υπάρχει η κεφαλίδα Authorization με τη λέξη Bearer, ένα κενό και το token.
401 invalid_tokenΤο token είναι λάθος ή έχει ανακληθεί.Αντιγράψτε το ολόκληρο ξανά· αν το έχετε χάσει, δημιουργήστε νέο.
401 token_expiredΤο token δεν χρησιμοποιήθηκε για 60 ημέρες και απενεργοποιήθηκε.Δημιουργήστε νέο από τη σελίδα Report.
429 rate_limitedΠερισσότερες από 10 κλήσεις σε ένα λεπτό.Περιμένετε ένα λεπτό και μειώστε τη συχνότητα.
429 daily_quota_exceededΈχετε ήδη κάνει 300 κλήσεις σήμερα.Δοκιμάστε ξανά αύριο και μειώστε τη συχνότητα.
400 bad_requestΚάποια παράμετρος δεν είναι σωστή: ημερομηνία όχι σε μορφή ΕΕΕΕ-ΜΜ-ΗΗ, from μεταγενέστερη από to, πολύ μεγάλη περίοδος, granularity διαφορετική από hour, day ή month.Διορθώστε την παράμετρο που αναφέρεται στο μήνυμα.

Έτοιμα παραδείγματα

Home Assistant

Με την ενσωμάτωση RESTful του Home Assistant μπορείτε να δημιουργήσετε αισθητήρες που διαβάζουν /status. Στο αρχείο secrets.yaml αποθηκεύστε το token, με τη λέξη Bearer μπροστά:

heiwit_aicare: "Bearer aic_IL_TUO_TOKEN"

Στη συνέχεια προσθέστε στο configuration.yaml:

rest:
  - resource: https://ai-care.heiwit.com/api/v1/status
    scan_interval: 600
    headers:
      Authorization: !secret heiwit_aicare
    sensor:
      - name: "Heiwit produzione FV"
        value_template: "{{ value_json.now.pv_w }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "Heiwit batteria"
        value_template: "{{ value_json.now.battery_soc }}"
        unit_of_measurement: "%"
        device_class: battery
      - name: "Heiwit scambio con la rete"
        value_template: "{{ value_json.now.grid_w }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "Heiwit energia prodotta"
        value_template: "{{ value_json.lifetime_kwh.pv }}"
        unit_of_measurement: "kWh"
        device_class: energy
        state_class: total_increasing

Με scan_interval: 600 Το Home Assistant καλεί το API κάθε 10 λεπτά: 144 κλήσεις την ημέρα. Τα υπόλοιπα σύνολα του lifetime_kwh (έγχυση, απορρόφηση από το δίκτυο, μπαταρία) προστίθενται όπως ο αισθητήρας «παραγόμενη ενέργεια» και μπορούν να χρησιμοποιηθούν στον πίνακα Ενέργεια.

Python

import requests

TOKEN = "aic_IL_TUO_TOKEN"

risposta = requests.get(
    "https://ai-care.heiwit.com/api/v1/energy",
    headers={"Authorization": f"Bearer {TOKEN}"},
    params={"granularity": "day", "from": "2026-09-01", "to": "2026-09-30"},
    timeout=30,
)
risposta.raise_for_status()

for giorno in risposta.json()["data"]:
    print(giorno["date"], giorno["pv_kwh"], "kWh prodotti")

Excel

  1. Στο Excel ανοίξτε Δεδομένα › Από το Web και επιλέξτε Για προχωρημένους.
  2. Ως διεύθυνση επικολλήστε:
    https://ai-care.heiwit.com/api/v1/energy?granularity=day&format=csv&delimiter=semicolon&decimal=comma
  3. Στις κεφαλίδες του αιτήματος HTTP γράψτε Authorization και, δίπλα, Bearer aic_IL_TUO_TOKEN.
  4. Αν το Excel ρωτήσει πώς να συνδεθεί, επιλέξτε Ανώνυμη: η εξουσιοδότηση βρίσκεται ήδη στην κεφαλίδα.
  5. Φορτώστε τον πίνακα. Από εκεί και πέρα, η εντολή Ανανέωση όλων τον φορτώνει ξανά με τα νέα δεδομένα.

Χωρίς from και to λαμβάνετε πάντα τις τελευταίες 30 ημέρες. Προσοχή: το token παραμένει αποθηκευμένο στο αρχείο και όποιος λάβει το αρχείο μπορεί να διαβάσει τα δεδομένα της εγκατάστασης.

Για εγκαταστάτες και επιχειρήσεις

  • Ένα token ανά εγκατάσταση. Με τον κύριο λογαριασμό του εγκαταστάτη βλέπετε στο AI-Care τις εγκαταστάσεις που παρακολουθείτε και για καθεμία μπορείτε να δημιουργήσετε ένα token από τη σελίδα Report. Τα όρια και η λήξη ισχύουν ανά token: με 40 εγκαταστάσεις έχετε 40 token, το καθένα με τις δικές του 300 κλήσεις την ημέρα.
  • Οι λογαριασμοί αντιπροσώπων δεν βλέπουν την ενότητα Accesso via API (Πρόσβαση μέσω API): απαιτείται ο κύριος λογαριασμός του εγκαταστάτη.
  • Τα δεδομένα ανήκουν στον πελάτη. Χρησιμοποιήστε τα για τις υπηρεσίες που έχετε συμφωνήσει μαζί του. Ο πελάτης βλέπει στη δική του σελίδα Report όλα τα ενεργά token της εγκατάστασής του, ακόμη και όσα δημιουργήσατε εσείς, με όνομα και τελευταία χρήση, και μπορεί να τα ανακαλέσει. Δώστε στα token σαφή ονόματα, για παράδειγμα «Συντήρηση Rossi Impianti».
  • Αν ένας πελάτης θέλει να σας εμπιστευτεί τα δεδομένα του (άρθρο 5 του Data Act), ο απλούστερος τρόπος είναι να δημιουργήσει ο ίδιος ένα ειδικό token και να σας το παραδώσει. Θα μπορεί να το ανακαλέσει όταν λήξει η συνεργασία.

Το ίδιο ισχύει για εταιρείες λογισμικού, ενεργειακούς συμβούλους και ενεργειακές κοινότητες: συνδέονται με ένα token ανά εγκατάσταση, το οποίο δημιουργεί και τους παραδίδει ο κάτοχος.

Ασφάλεια: τι δεν κάνει αυτό το API

  • Δεν παρέχει διαπιστευτήρια διαχείρισης του inverter.
  • Δεν τροποποιεί firmware, ηλεκτρικές παραμέτρους ή ρυθμίσεις προστασίας: μόνο διαβάζει.
  • Το token δεν ανοίγει τον λογαριασμό σας AI-Care και δεν δίνει πρόσβαση σε άλλες εγκαταστάσεις.

Ωστόσο, χειριστείτε το token σαν κωδικό πρόσβασης: μην το δημοσιεύετε στο διαδίκτυο, μην το αφήνετε σε κοινόχρηστα αρχεία, μην το στέλνετε σε chat. Αν φοβάστε ότι κάποιος το είδε, ανακαλέστε το και δημιουργήστε νέο. Η Heiwit διατηρεί μόνο ένα αποτύπωμα (hash) του token, όχι το ίδιο το token: γι' αυτό κανείς, ούτε η τεχνική υποστήριξη, δεν μπορεί να σας το ξαναστείλει. Η επικοινωνία με το API είναι κρυπτογραφημένη (HTTPS).

Συχνές ερωτήσεις

Πόσο κοστίζει;

Τίποτα. Η πρόσβαση στα δεδομένα που σας αναλογούν είναι δωρεάν.

Μπορώ να αλλάξω τις ρυθμίσεις του inverter μέσω του API;

Όχι. Το API είναι μόνο για ανάγνωση: δεν επηρεάζει firmware, ηλεκτρικές παραμέτρους ή προστασίες.

Μπορώ να δώσω τα δεδομένα μου στον εγκαταστάτη ή σε άλλη εταιρεία;

Ναι. Το Data Act σάς επιτρέπει να τα θέσετε στη διάθεση τρίτου που έχετε ορίσει εσείς. Στην πράξη δημιουργείτε ένα token με αναγνωρίσιμο όνομα και το παραδίδετε σε όποιον έχετε επιλέξει· μπορείτε να το ανακαλέσετε όποτε θέλετε. Για διαφορετικά αιτήματα γράψτε στην τεχνική υποστήριξη.

Έχασα το token. Μπορείτε να μου το ξαναστείλετε;

Όχι, γιατί η Heiwit δεν το διατηρεί. Δημιουργήστε νέο και ανακαλέστε το παλιό.

Λήγει το token;

Μόνο αν δεν το χρησιμοποιείτε: μετά από 60 ημέρες χωρίς κλήσεις απενεργοποιείται αυτόματα. Όσο το χρησιμοποιείτε, παραμένει ενεργό.

Μπορώ να διαβάζω περισσότερες εγκαταστάσεις με ένα μόνο token;

Όχι, κάθε token ισχύει για μία εγκατάσταση. Για περισσότερες εγκαταστάσεις χρειάζονται περισσότερα token.

Οι τιμές σε ευρώ είναι αυτές του λογαριασμού ρεύματος;

Όχι. Είναι εκτιμήσεις που υπολογίζονται με την τιμή χονδρικής της ενέργειας (PUN) της περιόδου.

Πόσο πίσω στον χρόνο μπορώ να πάω;

Έως την αρχή των δεδομένων που έχει καταγράψει η παρακολούθηση. Με ωριαία ανάλυση κάθε αίτημα καλύπτει έως 400 ημέρες.

Λειτουργεί με το Home Assistant;

Ναι, με την ενσωμάτωση RESTful: θα βρείτε τη διαμόρφωση στα παραδείγματα παραπάνω.

Χρήσιμοι σύνδεσμοι


Κανονιστικές αναφορές: Κανονισμός (ΕΕ) 2023/2854 του Ευρωπαϊκού Κοινοβουλίου και του Συμβουλίου, της 13ης Δεκεμβρίου 2023 (Data Act), ιδίως το άρθρο 4, για την πρόσβαση του χρήστη στα δεδομένα, και το άρθρο 5, για την κοινοποίησή τους σε τρίτους. Η πρόσβαση στα δεδομένα που δικαιούται ο χρήστης είναι δωρεάν, κατόπιν επαλήθευσης της νομιμοποίησης του αιτούντος· η διάθεση των δεδομένων σε τρίτο που έχει οριστεί από τον χρήστη πραγματοποιείται υπό τους όρους που προβλέπει ο κανονισμός. Οι τεχνικές πληροφορίες αφορούν την έκδοση 1 του API (/api/v1) στις 5 Οκτωβρίου 2026.

Θεματικές κατηγορίες