Για να κάνουμε δημιουργία εφαρμογής στο GovHub, θα κάνουμε τα παρακάτω βήματα.
Εισαγωγή στην ιστοσελίδα http://auth.govhub.gr με τους κωδικούς του διαχειριστή του φορέα.
Παραγωγικό περιβάλλον: GovHub.VevaiosiMonimisKatoikias.Basic
Δοκιμαστικό περιβάλλον: GovHub.VevaiosiMonimisKatoikias.Test
Για να καλέσουμε τα api του Govhub πρώτα πρέπει έχουμε κάνει authenticate σαν εφαρμογή και να πάρουμε ένα JWT Token.
Οδηγίες για λήψη JTW token από τον auth Server
Αφού λάβουμε το JWT Token σύμφωνα με το Auth 2.0 πρότυπο θα πρέπει να κάνετε Bearer Authentication.
Authorization: Bearer <token>
Πριν καλέσετε τα Api δείτε τις οδηγίες για τη συμπλήρωση του "auditRecord"
Yπάρχουν αναλυτικές οδηγίες στα HTTP Calls που πρέπει να γίνουν στις διευθύνσεις.
Η διαδρομή είναι /api/v{api-version}/<endpoint>.
| Endpoint | Method | Επιστρέφει |
|---|---|---|
VMK/GetVevaiosiMonimisKatoikiasDataByAfm |
POST |
JSON με τα στοιχεία βεβαίωσης |
VMK/GetVevaiosiMonimisKatoikiasDataByAdt |
POST |
JSON με τα στοιχεία βεβαίωσης |
VMK/GetVevaiosiMonimisKatoikiasReportByAfm |
POST |
Αρχείο (εκτυπωτικό βεβαίωσης) |
VMK/GetVevaiosiMonimisKatoikiasReportByAdt |
POST |
Αρχείο (εκτυπωτικό βεβαίωσης) |
VMK/AppsGetDataByAfm |
POST |
JSON — ίδιο request με το DataByAfm |
VMK/Settings/GetAllYpografontes |
GET |
Λίστα υπογραφόντων |
VMK/Settings/CreateYpografontes |
POST |
Δημιουργία υπογράφοντα |
VMK/Settings/UpdateYpografontes |
POST |
Ενημέρωση υπογράφοντα |
VMK/Settings/DeleteYpografontes |
POST |
Διαγραφή υπογράφοντα |
Και τα τέσσερα endpoints άντλησης δέχονται την ίδια δομή: auditRecord και input.
Προσοχή: το αντικείμενο εισόδου ονομάζεται σκέτο
input, όχι<κλήση>InputRecordόπως σε άλλα API του GovHub.
Με ΑΦΜ (...DataByAfm, ...ReportByAfm, AppsGetDataByAfm):
{
"auditRecord": {
"auditTransactionId": "...",
"auditProtocolNumber": "...",
"auditProtocolDate": "2026-01-15T10:00:00Z",
"auditUserId": "...",
"auditUserIp": "..."
},
"input": {
"afm": "004413866"
}
}
Με ΑΔΤ (...DataByAdt, ...ReportByAdt):
{
"auditRecord": { },
"input": {
"adt": "Χ156594"
}
}
Τα Report* επιστρέφουν αρχείο, όχι JSON — είναι το εκτυπωτικό της βεβαίωσης. Τα Data* επιστρέφουν τα στοιχεία σε JSON.
Τα ίδια στοιχεία που ρυθμίζονται από το UI (δείτε Αλλαγή υπογράφοντα) είναι διαθέσιμα και προγραμματιστικά.
Το CreateYpografontes και το UpdateYpografontes δέχονται:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
id |
integer | Αναγνωριστικό εγγραφής (στο Create αγνοείται) |
apo |
date-time | Έναρξη ισχύος |
eos |
date-time | Λήξη ισχύος |
ypografonOnomateponymo |
string | Ονοματεπώνυμο υπογράφοντα |
ypografonTitlos |
string | Τίτλος/ιδιότητα |
ypografonFylo |
integer | Φύλο: 0 Άγνωστο, 1 Θήλυ, 2 Άρρεν, 3 Απροσδιόριστο |
sxolia |
string | Σχόλια |
municipalityTin |
string | ΑΦΜ Δήμου |
{
"id": 0,
"apo": "2026-01-01T00:00:00Z",
"eos": "2026-12-31T00:00:00Z",
"ypografonOnomateponymo": "ΟΝΟΜΑ ΕΠΩΝΥΜΟ",
"ypografonTitlos": "Δήμαρχος",
"ypografonFylo": 2,
"sxolia": "",
"municipalityTin": "090001251"
}
Το DeleteYpografontes δέχεται στο body μόνο το id της εγγραφής. Το GetAllYpografontes είναι GET χωρίς παραμέτρους και επιστρέφει τη λίστα.
Οι ημερομηνίες ισχύος δεν πρέπει να επικαλύπτονται με υπάρχουσες εγγραφές. Αν δεν οριστεί υπογράφων για κάποια ημερομηνία, επιλέγεται αυτόματα ο αντίστοιχος Δήμαρχος.
| Τύπος | Τιμές |
|---|---|
| Α.Δ.Τ. | Χ156594, ΩΩ123456 |
| Α.Φ.Μ. | 004413866, 000000009 |