Live αναζήτηση

Δοκιμάστε το API με πραγματικό request

Επιλέξτε τύπο αναζήτησης, εισάγετε τιμή και δείτε endpoint, πίνακα αποτελεσμάτων και raw JSON.

Τύπος αναζήτησης

Το postcode πρέπει να έχει ακριβώς 5 ψηφία.

Τα αποτελέσματα θα εμφανιστούν εδώ μετά την αναζήτηση.

Endpoints

Πώς συνδέονται οι δύο αναζητήσεις

Το postcode endpoint ξεκινά από τον ταχυδρομικό κώδικα. Το place endpoint ξεκινά από όνομα περιοχής και επιστρέφει αντιστοιχίσεις με βάση το πρόθεμα.

Ακριβής αναζήτηση Τ.Κ. GET

Αναζήτηση με ταχυδρομικό κώδικα

Επιστρέφει όλες τις περιοχές και τις οδούς που αντιστοιχούν σε έναν έγκυρο 5ψήφιο ταχυδρομικό κώδικα.

Το {postcode} πρέπει να περιέχει ακριβώς 5 ψηφία. Κενά μέσα στην τιμή αφαιρούνται πριν γίνει η αναζήτηση.

Δείτε και την αναζήτηση με περιοχή
/api/postcode/{postcode} Άνοιγμα endpoint

Παράδειγμα επιτυχούς απόκρισης

{
  "ok": true,
  "type": "postcode",
  "query": "10431",
  "count": 1,
  "results": [
    {
      "postcode": "10431",
      "place": "ΑΘΗΝΑ",
      "streets": [
        {
          "street": "3ης Σεπτεμβρίου",
          "numberRange": "1-3 2-4"
        }
      ]
    }
  ]
}

Παράδειγμα σφάλματος

{
  "ok": false,
  "type": "postcode",
  "query": "99999",
  "error": "postcode_not_found",
  "message": "Postcode not found."
}
Αναζήτηση περιοχής με πρόθεμα GET

Αναζήτηση με όνομα περιοχής

Επιστρέφει ταχυδρομικούς κώδικες και οδούς για περιοχές που ξεκινούν από το δοσμένο ελληνικό πρόθεμα.

Το {place} δεν πρέπει να είναι κενό. Η αναζήτηση κανονικοποιεί κεφαλαία, κενά και ελληνικούς τόνους.

Δείτε και την αναζήτηση με ταχυδρομικό κώδικα
/api/place/{place} Άνοιγμα endpoint

Παράδειγμα επιτυχούς απόκρισης

{
  "ok": true,
  "type": "place",
  "query": "ΑΘΗΝΑ",
  "count": 1,
  "results": [
    {
      "place": "ΑΘΗΝΑ",
      "postcode": "10431",
      "streets": [
        {
          "street": "3ης Σεπτεμβρίου",
          "numberRange": "1-3 2-4"
        }
      ]
    }
  ]
}

Παράδειγμα σφάλματος

{
  "ok": false,
  "type": "place",
  "query": "ΑΝΥΠΑΡΚΤΟ",
  "error": "place_not_found",
  "message": "Place not found."
}

Παραδείγματα κώδικα

Έτοιμα examples για cURL, PHP cURL και JavaScript

Χρησιμοποιήστε τα samples ως βάση για checkout validation, admin εργαλεία ή backend integrations.

Samples για postcode lookup

cURL

curl "https://support.opencartgreece.gr/api/postcode/10431"

PHP cURL

<?php
$url = 'https://support.opencartgreece.gr/api/postcode/10431';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode >= 400 || empty($data['ok'])) {
    throw new RuntimeException($data['message'] ?? (string) $httpCode);
}

print_r($data['results']);

JavaScript fetch

const response = await fetch('/api/postcode/10431', {
  headers: { Accept: 'application/json' },
});

const data = await response.json();

if (!response.ok || !data.ok) {
  throw new Error(data.message ?? String(response.status));
}

console.log(data.results);

Samples για place lookup

cURL

curl "https://support.opencartgreece.gr/api/place/%CE%91%CE%98%CE%97%CE%9D%CE%91"

PHP cURL

<?php
$url = 'https://support.opencartgreece.gr/api/place/%CE%91%CE%98%CE%97%CE%9D%CE%91';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode >= 400 || empty($data['ok'])) {
    throw new RuntimeException($data['message'] ?? (string) $httpCode);
}

print_r($data['results']);

JavaScript fetch

const response = await fetch('/api/place/%CE%91%CE%98%CE%97%CE%9D%CE%91', {
  headers: { Accept: 'application/json' },
});

const data = await response.json();

if (!response.ok || !data.ok) {
  throw new Error(data.message ?? String(response.status));
}

console.log(data.results);

Συχνές ερωτήσεις

Τι πρέπει να γνωρίζετε πριν το χρησιμοποιήσετε

Σύντομες απαντήσεις για πρόσβαση, validation, μορφή αποτελεσμάτων και διαθέσιμα errors.

Πότε να χρησιμοποιήσω αυτό το API;

Χρησιμοποιήστε το όταν χρειάζεστε γρήγορο postcode lookup σε checkout validation, courier workflows, admin εργαλεία ή backend integrations.

Τι δέχεται το /api/postcode/{postcode};

Δέχεται έναν ελληνικό ταχυδρομικό κώδικα με ακριβώς 5 ψηφία. Αν η τιμή δεν είναι έγκυρη, επιστρέφεται JSON error με ok: false.

Πώς λειτουργεί το /api/place/{place};

Η αναζήτηση γίνεται ως prefix lookup σε ελληνικές περιοχές. Το API κανονικοποιεί κεφαλαία, επιπλέον κενά και τόνους.

Ποια είναι η μορφή της απόκρισης;

Σε επιτυχία επιστρέφονται ok, type, query, count και results. Κάθε result περιλαμβάνει place, postcode και λίστα streets με street και numberRange.

Τι γίνεται όταν δεν υπάρχει αποτέλεσμα;

Το API επιστρέφει JSON error με ok: false, type, query, error και message. Τα άγνωστα postcodes ή places επιστρέφουν 404.

Χρειάζεστε custom postcode ή courier workflow;

Μπορούμε να προσαρμόσουμε validation, checkout flows ή courier integrations για το δικό σας OpenCart κατάστημα.

Μιλήστε μαζί μας