Μετάβαση στο περιεχόμενο

Εξωτερικό 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