# Δοκιμαστικό API key για myDATA: πού το βρίσκεις στο Wrapp, ανάλογα με το πού είσαι

> Το δοκιμαστικό API key του Wrapp το ανοίγεις μόνος σου, δωρεάν, από τον λογαριασμό σου στο wrapp.ai. Το κουμπί όμως αλλάζει θέση ανάλογα με το πού βρίσκεσαι. Εδώ είναι κάθε σημείο, η πρώτη κλήση στο staging και τι κάνεις όταν κάτι δεν δουλεύει.
>
> AI-friendly Markdown version. HTML version: https://wrapp.ai/el/resources/dokimastiko-api-key-staging-mydata
> EN version: https://wrapp.ai/en/resources/mydata-sandbox-api-key-test-environment.md

Θέλεις να συνδέσεις την εφαρμογή, το POS ή το ERP σου με το Wrapp API και να δοκιμάσεις πριν βγεις σε παραγωγή. Χρειάζεσαι δύο πράγματα: ένα **email σύνδεσης** και ένα **δοκιμαστικό API key** για το **staging.wrapp.ai**, το δοκιμαστικό περιβάλλον του Wrapp. Τα ανοίγεις μόνος σου, δωρεάν, χωρίς φόρμα και χωρίς να περιμένεις email από εμάς.

**Το κουμπί «Δοκίμασε το API» δεν είναι πάντα στην οθόνη σου, και αυτό δεν είναι σφάλμα.** Εμφανίζεται μόνο στο πρώτο βήμα της ρύθμισης του λογαριασμού. Από το δεύτερο βήμα και μετά, το δοκιμαστικό key είναι στο αριστερό μενού. Μετά την ενεργοποίηση, είναι στις Ρυθμίσεις. Όλα ανοίγουν τον ίδιο δοκιμαστικό λογαριασμό.

### Αν δεν έχεις ακόμη λογαριασμό

- Κάνε [δωρεάν εγγραφή στο wrapp.ai](https://wrapp.ai/el/users/new) με το ΑΦΜ της επιχείρησης.
- Όρισε τον κωδικό σου.
- Στο πρώτο βήμα της ρύθμισης, στο πλαίσιο «Θες να δοκιμάσεις πρώτα;», πάτα **«Δοκίμασε το API»**.

Ο δοκιμαστικός λογαριασμός ανοίγει στο staging.wrapp.ai και σου δείχνει αμέσως τα στοιχεία πρόσβασης. Δεν χρειάζεται να ολοκληρώσεις πρώτα την ενεργοποίηση: δοκιμάζεις όσο προχωράς με την εγγραφή.

### Πού είναι το κουμπί, ανάλογα με το πού βρίσκεσαι

| Πού βρίσκεσαι | Τι πατάς |
| --- | --- |
| Πρώτο βήμα της ρύθμισης του λογαριασμού | «Δοκίμασε το API», στο πλαίσιο «Θες να δοκιμάσεις πρώτα;» |
| Δεύτερο βήμα της ρύθμισης και μετά | Αριστερό μενού: «Δοκίμασε δωρεάν» → «Δοκιμαστικό API key» |
| Ενεργοποιημένος λογαριασμός | Ρυθμίσεις → «Demo account» |
| Το παράθυρο «Στοιχεία API» δείχνει λουκέτο | «Δοκίμασε δωρεάν στο demo», μέσα στο ίδιο παράθυρο |

Και τα τέσσερα οδηγούν στον **ίδιο** δοκιμαστικό λογαριασμό. Όσο η ρύθμιση δεν έχει ολοκληρωθεί, οι Ρυθμίσεις δεν ανοίγουν, γι' αυτό τότε το key είναι μόνο στο αριστερό μενού. Το «Demo account» ανοίγει τον λογαριασμό χωρίς το παράθυρο του API: τα στοιχεία τα βρίσκεις με ένα κλικ στο «Στοιχεία API», στην μπάρα στο πάνω μέρος.

Το λουκέτο στο «Στοιχεία API» σημαίνει ότι το API του λογαριασμού σου δεν έχει ανοίξει ακόμη για κανονική έκδοση: είτε δεν έχεις ολοκληρώσει την ενεργοποίηση, είτε το πακέτο σου δεν το περιλαμβάνει. Το δοκιμαστικό key δουλεύει και στις δύο περιπτώσεις.

### Τι βλέπεις όταν ανοίξει

Με το «Δοκίμασε το API» ή το «Δοκιμαστικό API key», ο δοκιμαστικός λογαριασμός ανοίγει μαζί με το παράθυρο **«Δοκίμασε το Wrapp API»**:

- **Email σύνδεσης**: το email του δοκιμαστικού λογαριασμού.
- **API key**: κρυφό στην αρχή, με «Εμφάνιση API key» και «Αντιγραφή».
- **Περιβάλλον**: staging.wrapp.ai, ο host όπου στέλνεις τις κλήσεις.
- Το κουμπί «Τεκμηρίωση API» και τρία πρώτα βήματα.

**Αντέγραψε το email σύνδεσης από το παράθυρο.** Δεν είναι ακριβώς το email με το οποίο γράφτηκες στο wrapp.ai, και το login στο staging θέλει αυτό του παραθύρου, μαζί με το δοκιμαστικό API key.

Όσο είσαι στον δοκιμαστικό λογαριασμό, μια μπάρα στο πάνω μέρος κάθε σελίδας σου θυμίζει ότι βρίσκεσαι στο δοκιμαστικό περιβάλλον. Από εκεί, το «Στοιχεία API» ξανανοίγει το παράθυρο όποτε το χρειαστείς, και το «Επιστροφή στο wrapp.ai» σε γυρίζει στον κανονικό σου λογαριασμό. Το ίδιο κάνει και η αποσύνδεση.

Ο λογαριασμός έρχεται έτοιμος: οι σειρές τιμολόγησης για τους βασικούς τύπους παραστατικών είναι ήδη στημένες, οπότε μπορείς να εκδώσεις αμέσως. Ό,τι εκδώσεις εκεί **δεν έχει φορολογική ισχύ**, και κάθε παραστατικό εμφανίζεται και στο web app του δοκιμαστικού λογαριασμού, με όλα τα στοιχεία του.

### Η πρώτη κλήση

Το πρώτο που κάνει το πρόγραμμά σου είναι login: `POST /api/v1/login` με το email σύνδεσης και το API key. Η απάντηση είναι ένα JWT που ισχύει **24 ώρες** και το στέλνεις στις επόμενες κλήσεις, όπως δείχνει η τεκμηρίωση.

POST /api/v1/login

```bash
curl -L 'https://staging.wrapp.ai/api/v1/login' \
  -H 'Content-Type: application/json' \
  -d '{ "email": "το email σύνδεσης από το παράθυρο", "api_key": "το δοκιμαστικό API key" }'
```

Μετά, το `GET /api/v1/billing_books` σου δίνει τις σειρές του δοκιμαστικού λογαριασμού και τα id τους, για να διαλέξεις σε ποια σειρά εκδίδεις. Από εκεί στέλνεις το πρώτο σου παραστατικό από την εφαρμογή σου. Το πλήρες σχήμα των πεδίων είναι στην [τεκμηρίωση του REST API](https://wrapp.ai/api/documentation).

Αν η περίπτωσή σου έχει δικές της απαιτήσεις, οι οδηγοί του API τις καλύπτουν με έτοιμα payloads: [πρατήρια καυσίμων](https://wrapp.ai/el/resources/kodikoi-kausimon-mydata-api-pratiria), [πωλήσεις για λογαριασμό τρίτων](https://wrapp.ai/el/resources/poliseis-gia-logariasmo-triton-mydata-api), [εξ αποστάσεως πωλήσεις με OSS](https://wrapp.ai/el/resources/oss-poliseis-eks-apostaseos-mydata) και [δελτίο παραγγελίας εστίασης](https://wrapp.ai/el/resources/deltio-paraggelias-estiasis-24-ores).

### Αν φτιάχνεις πλατφόρμα για πελάτες σου

Αν είσαι εταιρεία λογισμικού και ανοίγεις λογαριασμούς Wrapp για τους πελάτες σου, χρειάζεσαι και ένα **Partner API key** (`X-PARTNER-API-KEY`). Για δοκιμές το φτιάχνεις μέσα στον δοκιμαστικό λογαριασμό:

- Από το μενού, Συνδέσεις → «Partner Portal».
- Δώσε ένα όνομα partner και πάτα «Δημιουργία partner».
- Το Partner API key εμφανίζεται αμέσως.

Ο partner του staging είναι μόνο για δοκιμές. Στο wrapp.ai δημιουργείς ξεχωριστό, με δικό του key, από την ίδια οθόνη. Τον partner τον δημιουργεί διαχειριστής του λογαριασμού. Οι κλήσεις που ανοίγουν λογαριασμούς για τους πελάτες σου είναι στο [API onboarding συνεργατών](https://wrapp.ai/api/partnersonboarding), και πώς τους προσκαλείς και χωρίς κώδικα το δείχνει ο οδηγός για το [Partner Portal](https://wrapp.ai/el/resources/partner-portal-wrapp-prosklisi-pelaton).

### Όταν περάσεις σε παραγωγή

Το δοκιμαστικό key μένει στο staging. Με την ενεργοποίηση του λογαριασμού σου παίρνεις **νέο API key** για κανονική έκδοση, στο «Στοιχεία API» του wrapp.ai. Το API δεν περιλαμβάνεται σε όλα τα πακέτα: ποια το περιλαμβάνουν το βλέπεις στα [πακέτα του Wrapp](https://wrapp.ai/el/plans).

Ο δοκιμαστικός λογαριασμός δεν χάνεται. Από τις Ρυθμίσεις → «Demo account» γυρνάς σε αυτόν όποτε θέλεις, για να δοκιμάσεις κάτι πριν το βγάλεις στην παραγωγή.

### Αν κάτι δεν δουλεύει

| Τι βλέπεις | Γιατί | Τι κάνεις |
| --- | --- | --- |
| Το login στο staging αποτυγχάνει με το email σου | Ο δοκιμαστικός λογαριασμός έχει δικό του email σύνδεσης | Αντέγραψε το «Email σύνδεσης» από το παράθυρο |
| Δεν βλέπεις το «Δοκίμασε το API» | Έχεις περάσει το πρώτο βήμα της ρύθμισης | Αριστερό μενού: «Δοκίμασε δωρεάν» → «Δοκιμαστικό API key» |
| Δεν βρίσκεις το «Demo account» ή οι Ρυθμίσεις δεν ανοίγουν | Η ρύθμιση του λογαριασμού δεν έχει ολοκληρωθεί | Το ίδιο αριστερό μενού |
| Πήγες στο staging.wrapp.ai και δεν μπαίνεις, ούτε με Google | Το staging δεν έχει δική του σύνδεση | Συνδέσου στο wrapp.ai και πάτα ένα από τα κουμπιά του δοκιμαστικού |
| Το «Στοιχεία API» λέει «Ολοκλήρωσε πρώτα την ενεργοποίηση» | Το κανονικό key ανοίγει μετά την ενεργοποίηση | Πάτα «Δοκίμασε δωρεάν στο demo» στο ίδιο παράθυρο |
| Το δοκιμαστικό key αποτυγχάνει στο wrapp.ai | Το έστειλες στον κανονικό host | Στείλε το στο https://staging.wrapp.ai |
| Έκλεισες το παράθυρο και δεν έχεις το key |  | Πάτα «Στοιχεία API» στην μπάρα στο πάνω μέρος |

Για να ξεκινήσεις, κάνε [δωρεάν εγγραφή](https://wrapp.ai/el/users/new), ή ρίξε πρώτα μια ματιά στην [τεκμηρίωση του API](https://wrapp.ai/api/documentation).

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

### Πού βρίσκω το δοκιμαστικό API key του Wrapp;

Στον λογαριασμό σου στο wrapp.ai, και η θέση του εξαρτάται από το πού βρίσκεσαι. Στο πρώτο βήμα της ρύθμισης πατάς «Δοκίμασε το API». Από το δεύτερο βήμα και μετά, στο αριστερό μενού «Δοκίμασε δωρεάν» → «Δοκιμαστικό API key». Μετά την ενεργοποίηση, Ρυθμίσεις → «Demo account». Όλα ανοίγουν τον ίδιο δοκιμαστικό λογαριασμό στο staging.wrapp.ai.

### Δεν βλέπω το κουμπί «Δοκίμασε το API». Γιατί;

Γιατί εμφανίζεται μόνο στο πρώτο βήμα της ρύθμισης του λογαριασμού. Αν έχεις προχωρήσει, το δοκιμαστικό key είναι στο αριστερό μενού: «Δοκίμασε δωρεάν» → «Δοκιμαστικό API key». Δεν είναι σφάλμα, απλώς άλλαξε θέση.

### Το login στο staging αποτυγχάνει με το email μου. Γιατί;

Γιατί το email σύνδεσης του δοκιμαστικού λογαριασμού δεν είναι ακριβώς το email με το οποίο γράφτηκες στο wrapp.ai. Αντέγραψε το «Email σύνδεσης» από το παράθυρο «Δοκίμασε το Wrapp API» και στείλε το μαζί με το δοκιμαστικό API key.

### Μπορώ να συνδεθώ απευθείας στο staging.wrapp.ai;

Όχι. Το staging.wrapp.ai δεν έχει δική του σύνδεση, ούτε με κωδικό ούτε με Google. Μπαίνεις πάντα από τον λογαριασμό σου στο wrapp.ai, με ένα από τα κουμπιά του δοκιμαστικού. Το API του staging, αντίθετα, το καλεί απευθείας το πρόγραμμά σου.

### Δουλεύει το δοκιμαστικό API key στο wrapp.ai;

Όχι. Το δοκιμαστικό key δουλεύει μόνο στο https://staging.wrapp.ai, μαζί με το email σύνδεσης του δοκιμαστικού λογαριασμού. Για κανονική έκδοση παίρνεις νέο API key με την ενεργοποίηση του λογαριασμού σου.

### Κοστίζει κάτι το δοκιμαστικό περιβάλλον;

Όχι. Η εγγραφή στο wrapp.ai και ο δοκιμαστικός λογαριασμός είναι δωρεάν, και δεν χρειάζεται να μας στείλεις φόρμα ή email για να τον ανοίξεις.

### Έχουν φορολογική ισχύ όσα εκδίδω στο staging;

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

### Πώς παίρνω δοκιμαστικό Partner API key;

Μέσα στον δοκιμαστικό λογαριασμό: Συνδέσεις → «Partner Portal», δίνεις ένα όνομα και πατάς «Δημιουργία partner». Το Partner API key (X-PARTNER-API-KEY) εμφανίζεται αμέσως. Είναι μόνο για δοκιμές: στο wrapp.ai δημιουργείς ξεχωριστό partner, με δικό του key. Τον partner τον δημιουργεί διαχειριστής του λογαριασμού.

### Έκλεισα το παράθυρο με το key. Πού το ξαναβρίσκω;

Στην μπάρα στο πάνω μέρος του δοκιμαστικού λογαριασμού, πάτα «Στοιχεία API». Το παράθυρο ξανανοίγει με το email σύνδεσης και το API key.

Χρειάζεσαι βοήθεια; Επικοινώνησε μαζί μας: https://wrapp.ai/contact