Αν έχετε ελληνικό e-shop, αργά ή γρήγορα θα χρειαστεί να ελέγξετε ταχυδρομικούς κώδικες, περιοχές ή διευθύνσεις. Αυτό μπορεί να συμβεί στο checkout, στη δημιουργία αποστολής, σε ένα courier integration ή σε ένα εσωτερικό admin εργαλείο.
Γι’ αυτό δημιουργήσαμε ένα δωρεάν εργαλείο και δημόσιο JSON API για αναζήτηση ελληνικών ταχυδρομικών κωδικών και περιοχών: το ELTA Postcode API της OpenCart Greece.
Το εργαλείο είναι διαθέσιμο εδώ:
https://support.opencartgreece.gr/tools/elta-postcode-api/
Τι είναι το ELTA Postcode API;
Το ELTA Postcode API είναι ένα απλό δημόσιο API που επιστρέφει δεδομένα σε JSON μορφή. Μπορείτε να το χρησιμοποιήσετε για δύο βασικές αναζητήσεις:
- Αναζήτηση με ταχυδρομικό κώδικα.
- Αναζήτηση με όνομα περιοχής ή prefix περιοχής.
Δεν χρειάζεται API key για την τρέχουσα δημόσια χρήση και μπορείτε να δοκιμάσετε το API απευθείας από τη σελίδα του εργαλείου, χωρίς εγκατάσταση.
Ποια endpoints είναι διαθέσιμα;
Το API έχει δύο απλά GET endpoints:
/api/postcode/{postcode} Για αναζήτηση με 5ψήφιο ελληνικό ταχυδρομικό κώδικα.
Παράδειγμα:
/api/postcode/10431
και:
/api/place/{place} Για αναζήτηση με ελληνικό όνομα περιοχής ή prefix.
Παράδειγμα:
/api/place/ΑΘΗΝΑ
Η απόκριση επιστρέφει JSON με στοιχεία όπως ok, type, query, count και results, ώστε να μπορείτε να το συνδέσετε εύκολα σε browser, backend ή εσωτερικό εργαλείο.
Γιατί είναι χρήσιμο για e-shop και OpenCart καταστήματα;
Σε ένα ηλεκτρονικό κατάστημα, η ποιότητα των στοιχείων αποστολής επηρεάζει άμεσα την καθημερινή λειτουργία. Ένα λάθος postcode ή μία ασυμφωνία περιοχής μπορεί να δημιουργήσει καθυστέρηση, λάθος χρέωση μεταφορικών ή πρόβλημα στη δημιουργία voucher.
Με το δωρεάν ELTA Postcode API μπορείτε να χτίσετε πιο πρακτικές ροές, όπως:
- έλεγχο ταχυδρομικού κώδικα στο checkout,
- βοηθητικά πεδία για admin καταχώρηση παραγγελιών,
- εσωτερικά courier tools,
- γρήγορη αναζήτηση περιοχής από postcode,
- αναζήτηση postcode με βάση την περιοχή,
- debugging σε αποστολές που έχουν λάθος στοιχεία.
Δεν αντικαθιστά ένα πλήρες courier integration, αλλά δίνει ένα πολύ χρήσιμο σημείο εκκίνησης για validation, αναζήτηση και αυτοματοποίηση.
Πώς δοκιμάζετε το API χωρίς κώδικα;
Στη σελίδα του εργαλείου υπάρχει live φόρμα αναζήτησης. Επιλέγετε αν θέλετε αναζήτηση με Postcode ή Place, γράφετε την τιμή και βλέπετε άμεσα:
- το endpoint που καλείται,
- το status της αναζήτησης,
- το query,
- τον αριθμό αποτελεσμάτων,
- πίνακα με τα αποτελέσματα,
- raw JSON response.
Αυτό είναι ιδιαίτερα χρήσιμο πριν γράψετε κώδικα, γιατί βλέπετε πρώτα τη δομή της απόκρισης και αποφασίζετε πώς θα τη χρησιμοποιήσετε στο δικό σας project.
Παράδειγμα χρήσης με cURL
curl "https://support.opencartgreece.gr/api/postcode/10431"
Για αναζήτηση περιοχής:
curl "https://support.opencartgreece.gr/api/place/%CE%91%CE%98%CE%97%CE%9D%CE%91"
Πού μπορεί να χρησιμοποιηθεί πρακτικά;
Το API μπορεί να φανεί χρήσιμο σε αρκετές καθημερινές περιπτώσεις:
Checkout validation
Μπορείτε να ελέγχετε αν ένας ταχυδρομικός κώδικας έχει σωστή μορφή και να βοηθάτε τον πελάτη να συμπληρώσει πιο καθαρά στοιχεία αποστολής.
Admin εργαλεία
Σε τηλεφωνικές παραγγελίες ή manual καταχωρήσεις, ο διαχειριστής μπορεί να ψάχνει γρήγορα postcode ή περιοχή χωρίς να ανοίγει εξωτερικές σελίδες.
Courier workflows
Αν έχετε custom ροή για αποστολές, το API μπορεί να βοηθήσει στην προετοιμασία ή επαλήθευση δεδομένων πριν τη δημιουργία voucher.
Εσωτερικά integrations
Developers και agencies μπορούν να το χρησιμοποιήσουν ως lightweight helper για δικά τους scripts, dashboards ή OpenCart επεκτάσεις.
Είναι δωρεάν;
Ναι, το εργαλείο και τα endpoints είναι διαθέσιμα δημόσια χωρίς API key για την τρέχουσα χρήση. Δεν προσθέτουμε υποσχέσεις για SLA ή συγκεκριμένα quotas, γιατί ο στόχος του εργαλείου είναι να προσφέρει ένα απλό, άμεσο και χρήσιμο lookup για developers, καταστήματα και ομάδες υποστήριξης.
Δοκιμάστε το δωρεάν εργαλείο
Μπορείτε να δοκιμάσετε το ELTA Postcode API εδώ:
Αν έχετε OpenCart κατάστημα και χρειάζεστε πιο ολοκληρωμένο workflow για μεταφορικά, courier integrations, checkout validation ή αυτοματισμούς αποστολών, η ομάδα της OpenCart Greece μπορεί να βοηθήσει με custom υλοποίηση πάνω στις ανάγκες του καταστήματός σας.