====== API ΠΛΑΤΦΟΡΜΑ ΔΗΛΩΣΗΣ ΔΙΟΡΘΩΣΗΣ Τ.Μ. ΑΚΙΝΗΤΩΝ ΠΡΟΣ ΤΟΥΣ ΟΤΑ -- tetragonika.govapp.gr  ======

Η πλατφόρμα Δήλωσης Διόρθωσης τ.μ. Ακινήτων προς τους ΟΤΑ ή αλλιώς ΠΔΔΤΜΑ, παρέχει api για σύνδεση με τρίτες εφαρμογές.

====1 Πληροφορίες για το API ====
  * [[https://e9govapp.demo.egritosgroup.gr/docs|Δοκιμαστικό περιβάλλον]]
  * [[https://tetragonika.govapp.gr/docs|Παραγωγικό περιβάλλον]]

====2 Οδηγίες Δημιουργίας Εφαρμογής στον auth.govhub.gr====
Για να κάνουμε δημιουργία εφαρμογής στο GovHub, θα κάνουμε τα παρακάτω βήματα.

  - Εισαγωγή στην ιστοσελίδα http://auth.govhub.gr με τους κωδικούς του διαχειριστή του φορέα.
  - Δημιουργία εφαρμογής με δικαίωμα GovApp.Tetragonika.Basic.


====3. Οδηγίες για την κλήση του API ====

Για να καλέσουμε τα api του ΠΔΔΤΜΑ πρώτα πρέπει έχουμε κάνει authenticate σαν εφαρμογή και να πάρουμε ένα JWT Token.

**Για το παραγωγικό περιβάλλον στο πεδίο scope συμπληρώνουμε GovApp.Tetragonika.Basic για το Δοκιμαστικό περιβάλλον στο πεδίο scope συμπληρώνουμε GovApp.Tetragonika.Test.**

[[dev-auth|Οδηγίες για λήψη JTW token από τον auth Server]]

Αφού λάβουμε το JWT Token σύμφωνα με το Auth 2.0 πρότυπο θα πρέπει να κάνετε Bearer Authentication. Εκτός από τον header Authorization θα πρέπει να δηλώσετε και το Header GovHub-UserName με ένα username το χρήστη που θα κάνει το Request. Ο χρήστης θα πρέπει να είναι χρήστης του auth.govhub.gr και να έχει το ρόλο "Χρήστης Πλατφόρμας Δήλωσης Διόρθωσης τ.μ. Ακινήτων προς τους ΟΤΑ (tetragonika.govapp.gr)".

<code>
Authorization: Bearer <token>
GovHub-UserName: {username}
</code>

Αφού ρυθμίσετε τους παραπάνω headers μπορείτε να κάνετε κλήσεις σύμφωνα με τις οδηγίες του OpenApi(παράγραφος 1 docs).

Στην κλήση "api/EmployeesStatements/GetPropertiesStatements" το json πρέπει να είναι της μορφής.
<code>
{
    "Start" : 0,
    "Length" : 10,
    "SearchColumns" : [
        //SearchColumnT
        {
            "ColumnName" = "powerSupplyNumber",
            "Value" = "07206367"
        }
    ],
    "orders" : [
        {
            "columnName" : "id", //column name
            "dir" : "asc"  // asc ή desc
        }
    ]
}
</code>

Φίλτρα υποστηρίζουμε στα παρακάτω πεδία
  * id
  * statementState
  * sentOnFrm
  * sentOnTo
  * ownerTin
  * ownerFullName
  * powerSupplyNumber
  * atak
  * totalProperties
  * hasPowerSupply


====4. Δοκιμαστικά Δεδομένα ====

<code>

AuthServerUrl = "https://auth.govhub.gr"
ClientId = "demo-client-govhub-tetragonika"
ClientSecret = "επικοινωνήστε με email"

GovHub-UserName = "admine9"

</code>