Αυτό το API σας δίνει τη δυνατότητα να ανακτήσετε καταχωρήσεις επιχειρήσεων, κατηγοριών και άλλων δεδομένων από την πλατφόρμα μας σε μορφή JSON. Είναι ιδανικό για προγραμματιστές που επιθυμούν να ενσωματώσουν τα δεδομένα του kalamataguide.gr σε άλλες εφαρμογές ή ιστοσελίδες.
Για να χρησιμοποιήσετε το API, απαιτείται ένα ενεργό API Key. Αν δεν έχετε ακόμη, Θα πρέπει να εγγραφείτε στην σελίδα μας και να αιτηθείτε API KEY από τον λογαριασμό σας.
Κάθε αίτημα προς το API πρέπει να περιλαμβάνει τα εξής:
Παρακάτω θα βρείτε παραδείγματα χρήσης, διαθέσιμες παραμέτρους και δομή των αποτελεσμάτων.
const url = 'https://www.kalamataguide.gr/api/getListings/';
const params = {
apikey : "XXXXXXXXXX",
parameter_name: XX,
parameter_name2: XX,
};
fetch(url + '?' + new URLSearchParams(params), {
method: 'GET',
})
.then(response => response.json())
.then(data => {
console.log(data);
})
.catch(error => {
console.error('ERROR:', error);
console.log(error.message);
});
Παρακάτω θα βρείτε αναλυτικά τη λίστα με τις διαθέσιμες παραμέτρους που μπορείτε να χρησιμοποιήσετε κατά την κλήση του API, ώστε να φιλτράρετε τα αποτελέσματα σύμφωνα με τις ανάγκες σας. Σε περίπτωση που δεν οριστούν παράμετροι, επιστρέφονται όλα τα διαθέσιμα αποτελέσματα χωρίς φιλτράρισμα.
| Παράμετρος | Περιγραφή | Επιλογές |
|---|---|---|
| id | Είναι το ID της καταχώρησης που θέλετε να καλέσετε | Integer: πχ 84 |
| code | Ο κωδικός της καταχώρησης | String: πχ "K122R10429" |
| category | Επιλέξτε να φιλτράρετε καταχωρήσεις συγκεκριμένης κατηγορίας | Integer: πχ 10 Κωδικοί 1 - Καφές & Πρωινό 2 - Φαγητό & Εστιατόρια 3 - Διασκέδαση 7 - Αγορές, Υπηρεσίες & Επαγγελματίες 8 - Δραστηριότητες 9 - Σημεία ενδιαφέροντος 10 - Διαμονή 13 - Οχήματα & Μετακίνηση 14 - Το Blog του Kalamataguide 16 - Οργάνωση εκδηλώσεων |
| place | Επιλέξτε να φιλτράρετε για συγκεκριμένη περιοχή | Integer: πχ 2 Κωδικοί 1 - Κέντρο Καλαμάτας & Γύρω περιοχή 2 - Παραλία Καλαμάτας & Μαρίνα 3 - Έξω από την Καλαμάτα |
| season | Επιλέξτε εποχικότητα καταχώρησης | Integer: πχ 1 Κωδικοί 0 - Ολο τον χρόνο 1 - Μόνο χειμώνα 2 - Μόνο καλοκαίρι |
| suggested | Επιλέξτε τις προτεινόμενες καταχωρήσεις μας | Integer: πχ 1 Κωδικοί 0 - Απλές καταχωρήσεις 1 - Προτεινόμενες |
| plan | Πακέτο καταχωρήσεων | Integer: πχ 3 Κωδικοί 1 - Δωρεάν πακέτο 2 - Βασικό πακέτο 3 - Πλήρες πακέτο |
| sort | Ταξινόμηση των καταχωρήσεων Επιλέξτε με ποια σειρά θέλετε να λάβετε τα αποτελέσματα |
Integer: πχ 5 Κωδικοί 1 - Ελληνικά Α-Ω 2 - Ελληνικά Ω-Α 3 - Αγγλικά A-Z 4 - Αγγλικά Z-A 5 - Πιο κοντά στο κέντρο 6 - Πιο μακριά από το κέντρο |
