API διαχείρισης πληροφοριών κοινωνικής ασφάλισης
Υπηρεσία διαχείρισης AMKA
Αυτό το περιεχόμενο είναι ανοικτού κώδικα. Βοηθήστε μας να το βελτιώσουμε.
Επισκόπηση
Στα πλαίσια της προσπάθειας μας για την καλύτερη διαλειτουργικότητα μεταξύ των οργανισμών της ακαδημαϊκής κοινότητας, και σε συνεργασία με την ΗΔΙΚΑ, η GUNet παρέχει στα μέλη της μια υπηρεσία επιβεβαίωσης, αναζήτησης και ανάκτησης πληροφοριών για τους Αριθμούς Μητρώου Κοινωνικής Ασφάλισης (ΑΜΚΑ) που είναι υποχρεωτικοί για όλα τα μέλη της Ακαδημαϊκής Κοινότητας. Μέσω της έγκυρης αντιστοίχησης των πληροφοριών που τηρούνται στα πληροφοριακά συστήματα των ακαδημαϊκών ιδρυμάτων για τα φυσικά πρόσωπα με τον ΑΜΚΑ τους, όπως τηρείται από την ΗΔΙΚΑ, δίνεται η δυνατότητα για καλύτερη διαλειτουργικότητα των διαδικασιών που εμπλέκουν ακαδημαϊκούς φορείς και φορείς της κοινωνικής ασφάλισης. Επίσης η υπηρεσία μπορεί να συνδράμει στην προσπάθεια βελτίωση της ποιότητας (από την άποψη της πληρότητας και της εγκυρότητας) των πληροφοριών που τηρούν τα ακαδημαϊκά ιδρύματα για τα μέλη τους.
Προαπαιτούμενα
Η υπηρεσία προορίζεται για χρήση από τα αρμόδια τμήματα των ακαδημαϊκών ιδρυμάτων που συμμετέχουν στην GUNet.
Πρωτού ένα ίδρυμα μπορεί να επωφεληθεί της υπηρεσίας θα πρέπει να του εκχωρηθεί ένα μυστικό κλειδί για το ίδρυμα, κατόπιν αίτησης των αρμόδιων προσώπων για την διασύνδεση των πληροφοριακών συστημάτων του ιδρύματος με τις υπηρεσίες της GUNet. Προς το παρόν τα μυστικά κλειδιά εκδίδονται μέσω της εφαρμογής του Academic ID. Το αρμόδιο πρόσωπο για την διαχείριση των πληροφοριακών συστημάτων μπορεί, αφού ταυτοποιηθεί μέσω της ομοσπονδίας της ΕΔΕΤ, συμπληρώνει την σχετική φόρμα ενδιαφέροντος. Αφού γίνει η αίτηση την, και αφού αυτή εγκριθεί, ενεργοποιείται το κλειδί και η πρόσβαση στην υπηρεσία θα είναι δυνατή.
Τεκμηρίωση
Το API της υπηρεσίας είναι διαθέσιμο αρχικά μέσω τεχνολογιών JSON-RPC και REST. Ακολουθεί η τεκμηρίωση για αυτές τις διεπαφές.
Διεπαφή REST
Η διεπαφή REST είναι ένα είδος Web API, που προτείνεται για την κατανάλωση υπηρεσιών που παρέχονται από τρίτους λόγω της ευελιξίας που προσφέρει και την ευκολία εξέλιξης στο μέλλον. Είναι τεχνολογία ανεξάρτητη από συγκεκριμένες πλατφόρμες λειτουργικών ή προγραμματιστικών περιβάλλοντων και βασίζεται εξ’ολοκλήρου στο πρωτόκολλο HTTP και τις αρχές REST. To url της υπηρεσίας είναι το https://amka-services.gunet.gr .
Παράδειγμα χρήσης με REST
Παρακάτω θα βρείτε ένα ενδεικτικό παράδειγμα χρήσης του API μέσω της διεπαφής REST και του γνωστού προγράμματος curl
. Υποθέτουμε ότι σας έχει εκχωρηθεί το μυστικό κλειδί 12345678912345678912345678912345
:
curl -v -G \
-X GET "https://amka-services.gunet.gr/api/rest/v1/ssn_validation" \
-d "ssn=12312312312" \
-d "birthdate=1995-01-01" \
--data-urlencode "surname=ΧΡΗΣΤΗΣ" \
-H "Accept: application/json" \
-H "Authorization: Token 12345678912345678912345678912345"
{ "match": "true",
"ssn": "12312312312",
"father_en":"FATHERNAME",
"birth_country":"ΕΛΛΑΔΑ",
"address_prefecture":"ΑΤΤΙ",
"sex":"A",
"birth_municipality":"ΑΤΤΙΚΗ",
"address_country":"ΕΛΛΑΔΑ",
"citizenship":"ΕΛΛΑΔΑ",
"surname_cur_en":"USER",
"id_num":"XX000000",
"father_gr":"ΠΑΤΡΩΝΥΜΟ",
"tel1":"210-1234567",
"tel2":"210-1234568",
"last_mod_date":"01/01/1995",
"id_type":"T",
"surname_cur_gr":"ΧΡΗΣΤΗΣ",
"tid":"123654987",
"id_creation_year":"1995",
"death_date":"01/01/1995",
"birth_date":"01/01/1995",
"name_en":"TEST",
"address_country_code":"ΕΛ",
"surname_birth_gr":"ΧΡΗΣΤΗΣ",
"surname_birth_en":"USER",
"amka_cur":"12312312312",
"mother_en":"MOTHERNAME",
"mother_gr":"ΜΗΤΡΩΝΥΜΟ",
"death_note":"Λ",
"name_gr":"ΔΟΚΙΜΑΣΤΙΚΟΣ",
"address_town":"ΑΘΗΝΑ",
"amka_in":"12312312312",
"address_zipcode":"12345",
"birth_municipality_greek_code":"ΑΤΤΙ",
"bdate_istrue":"Π",
"birth_country_code":"ΕΛ",
"address_street":"ΠΑΝΕΠΙΣΤΗΜΙΟΥΠΟΛΗ" }
Παράδειγμα χρήσης JAVA
Παράδειγμα χρήσης Python
Παράδειγμα PHP
Παραδείγματα απαντήσεων
Για αναλυτικά παραδείγματα απαντήσεων της υπηρεσίας, μπορείτε να δείτε τον επίσημο οδηγό της υπηρεσίας
Διεπαφή JSON-RPC
Η τεχνολογία JSON-RPC είναι ένα διαδεδομένο πρωτόκολο κλήσης απομακρυσμένων μεθόδων (Remote Procedure Call) για το οποίο υπάρχουν πολλές έτοιμες υλοποιήσεις για διάφορες πλατφόρμες και γλώσσες προγραμματισμού. Βασίζεται στην τεχνολογία HTTP και JSON. Η υπηρεσία υποστηρίζει την έκδοση JSON-RPC 2.0. Πλήρης τεκμηρίωση για την διεπαφή JSON-RPC, στα Αγγλικά, καθώς και ένα διαδραστικό περιβάλλον για δοκιμές μπορεί να βρεθεί στην παρακάτω σελίδα:
Παράδειγμα χρήσης με JSON-RPC με χρήση της γλώσσας Perl
Παρακάτω θα βρείτε ένα ενδεικτικό παράδειγμα χρήσης του API μέσω της διεπαφής JSON-RPC κάνοντας χρήση της γλώσσας Perl. Υποθέτουμε ότι σας έχει εκχωρηθεί το μυστικό κλειδί 209802983402983049280394
με αναγνωριστικό ID 7
:
TODO