Εξωτερικό API¶
Δύο endpoints για τρίτους, κάτω από /api/public.
Το κλειδί partner (X-PARTNER-API-KEY) χρειάζεται μόνο στην εγγραφή. Η ανάγνωση στοιχείων επιχείρησης γίνεται με το uid που επιστρέφει η εγγραφή.
Το σώμα της εγγραφής μπορεί να είναι application/json ή φόρμα application/x-www-form-urlencoded.
Η επιτυχής απάντηση έχει τη μορφή:
{
"success": true,
"message": "OK",
"data": {}
}
Σφάλμα:
{
"success": false,
"message": "Περιγραφή",
"errors": []
}
Εγγραφή επιχείρησης¶
POST /api/public/register
Ζητά το κλειδί partner, με έναν από τους δύο τρόπους:
| Τρόπος | Τιμή |
|---|---|
| Κεφαλίδα | X-PARTNER-API-KEY: {PARTNER_SIGNUP_API_KEY} |
| Κεφαλίδα | Authorization: Bearer {PARTNER_SIGNUP_API_KEY} |
Το κλειδί ορίζεται στο .env ως PARTNER_SIGNUP_API_KEY. Αν λείπει ή δεν ταιριάζει, η απάντηση είναι 401.
Δημιουργεί χρήστη, εταιρεία και δοκιμαστική συνδρομή. Το uid που επιστρέφεται είναι το κλειδί της εταιρείας και χρησιμοποιείται στο δεύτερο endpoint.
Σώμα¶
| Πεδίο | Υποχρεωτικό | Σημείωση |
|---|---|---|
email |
ναι | Email σύνδεσης του χρήστη |
password |
ναι | Τουλάχιστον 8 χαρακτήρες |
mobile ή phone |
ένα από τα δύο | Ακριβώς 10 ψηφία |
afm |
ναι | ΑΦΜ επιχείρησης, 9 ψηφία. Δεκτό και ως company_afm |
fname, lname |
όχι | Όνομα χρήστη |
confirm_password |
όχι | Αν σταλεί, πρέπει να ταιριάζει με τον κωδικό. Δεκτό και ως password_confirmation |
comname |
όχι | Επωνυμία. Δεκτό και ως company_name. Αλλιώς χρησιμοποιείται το ονοματεπώνυμο ή το email |
company_phone |
όχι | Τηλέφωνο επιχείρησης. Αλλιώς μένει το τηλέφωνο του χρήστη |
company_email |
όχι | Email επιχείρησης |
address, street_number, city, postalcode |
όχι | Διεύθυνση |
idtaxoffice |
όχι | Κωδικός ΔΟΥ. Δεκτό και ως doy ή taxoffice |
mydata_username |
όχι | Χρήστης myDATA |
mydata_password |
όχι | Κωδικός myDATA. Δεν επιστρέφεται από το API |
Τα ίδια πεδία της επιχείρησης γίνονται δεκτά και μέσα σε αντικείμενο company.
Απάντηση 200¶
{
"success": true,
"message": "Επιτυχής εγγραφή.",
"data": {
"uid": "64 δεκαεξαδικοί χαρακτήρες",
"company_id": 12,
"user_id": 34,
"login_header": "X-CARPET-TOKEN",
"login_url": "https://παράδειγμα.gr/auth/enter?uid=…"
}
}
Σφάλματα¶
| Κωδικός | Πότε |
|---|---|
401 |
Λείπει ή δεν ταιριάζει το κλειδί partner |
400 |
Λείπει πεδίο ή δεν είναι έγκυρο (email, τηλέφωνο, ΑΦΜ, κωδικός) |
409 |
Το email χρησιμοποιείται ήδη |
429 |
Πάνω από 30 εγγραφές την ώρα από την ίδια IP |
500 |
Αποτυχία δημιουργίας |
Στοιχεία επιχείρησης¶
GET /api/public/company
Δεν ζητά κλειδί partner. Επιστρέφει τα στοιχεία της επιχείρησης που αντιστοιχεί στο uid της εγγραφής.
Το uid δίνεται με έναν από τους δύο τρόπους:
- query:
GET /api/public/company?uid={uid} - κεφαλίδα:
X-CARPET-TOKEN: {uid}
Αν σταλούν και τα δύο, χρησιμοποιείται το query.
Απάντηση 200¶
{
"success": true,
"message": "OK",
"data": {
"company": {
"id": 12,
"comname": "Καθαριστήρια Δοκιμή",
"afm": "801790343",
"tax_office_id": 4,
"tax_office": "ΔΟΥ Αθηνών",
"phone": "2101234567",
"email": "info@example.gr",
"address": "Ερμού",
"street_number": "10",
"city": "Αθήνα",
"postalcode": "10563",
"created_at": "2026-11-03 10:00:00"
}
}
}
Κενά πεδία έρχονται ως null. Δεν επιστρέφονται το uid, ο κωδικός myDATA ούτε ο χρήστης myDATA. Ανενεργή επιχείρηση αντιμετωπίζεται ως μη ευρεθείσα.
Σφάλματα¶
| Κωδικός | Πότε |
|---|---|
400 |
Λείπει το uid ή δεν είναι δεκαεξαδικό |
404 |
Δεν υπάρχει ενεργή επιχείρηση με αυτό το uid |
429 |
Πάνω από 120 αιτήματα την ώρα από την ίδια IP |