Τροποποιήθηκε στις: 16 Aug, 2026

Αυτός ο οδηγός παρέχει τεκμηρίωση για την ενσωμάτωση με το Jooble REST API. Παρακάτω θα βρείτε πληροφορίες σχετικά με τη δημιουργία κλειδιού API, τα τελικά σημεία (endpoints), τις παραμέτρους αιτημάτων, τις μορφές JSON και τους συνήθεις κωδικούς απόκρισης. Εάν δεν έχετε ξεκινήσει ακόμη την ενσωμάτωση, ανατρέξτε στον αναλυτικό οδηγό μας σχετικά με το Πώς να συνδεθείτε στο Jooble REST API.

Σημαντικοί περιφερειακοί περιορισμοί:
Κάθε τομέας (χώρα) της Jooble απαιτεί το δικό του μοναδικό κλειδί REST API. Για παράδειγμα, ένα κλειδί που δημιουργείται στο jooble.org παρέχει πρόσβαση αποκλειστικά σε αγγελίες εργασίας στις ΗΠΑ. Για να αναζητήσετε θέσεις εργασίας για άλλες χώρες, εγγραφείτε και αποκτήστε ένα κλειδί API στον αντίστοιχο περιφερειακό τομέα (π.χ. uk.jooble.org/api/about για το Ηνωμένο Βασίλειο ή de.jooble.org/api/about για τη Γερμανία).

Όρια χρήσης API:
Το δωρεάν πρόγραμμα REST API περιλαμβάνει ένα συνολικό όριο διάρκειας ζωής 500 αιτημάτων ανά κλειδί (πρόκειται για ένα απόλυτο όριο διάρκειας ζωής, όχι μηνιαίο όριο).

Πώς να αποκτήσετε ένα κλειδί Jooble REST API

1. Εγγραφείτε σε έναν λογαριασμό στην πύλη API της Jooble για τη χώρα-στόχο σας (π.χ. gr.jooble.org/api/about).
2. Μόλις εγγραφείτε, αντιγράψτε και αποθηκεύστε με ασφάλεια το κλειδί API που δημιουργήθηκε.

Παράμετροι αιτήματος (Σώμα JSON)

Το ωφέλιμο φορτίο του αιτήματος πρέπει να αποσταλεί σε μορφή application/json με τις ακόλουθες παραμέτρους:

• keywords(συμβολοσειρά, υποχρεωτικό): Λέξεις-κλειδιά ή τίτλοι θέσεων εργασίας για αναζήτηση.
• location(συμβολοσειρά, υποχρεωτικό): Όνομα τοποθεσίας (πόλη, περιοχή ή χώρα).
• radius(συμβολοσειρά, προαιρετικό): Ακτίνα αναζήτησης σε χιλιόμετρα. Επιτρεπόμενες τιμές: 0, 4, 8, 16, 26, 40, 80.
• salary(ακέραιος, προαιρετικό): Ελάχιστο όριο μισθού.
• page(ακέραιος, προαιρετικό): Αριθμός σελίδας των αποτελεσμάτων αναζήτησης (προεπιλογή είναι το 1).
• ResultOnPage(ακέραιος, προαιρετικό): Αριθμός αποτελεσμάτων θέσεων εργασίας ανά σελίδα.
• SearchMode(ακέραιος, προαιρετικό): Λειτουργία αλγορίθμου αναζήτησης (προεπιλογή είναι το 0).
• companysearch(boolean, προαιρετικό):
  • true – Αναζήτηση λέξεων-κλειδιών συγκεκριμένα εντός ονομάτων εταιρειών.
  • false – Αναζήτηση λέξεων-κλειδιών σε τίτλους και περιγραφές θέσεων εργασίας.

Παράμετροι απόκρισης

Μετά από ένα επιτυχημένο αίτημα, ο διακομιστής επιστρέφει ένα αντικείμενο JSON που περιέχει:

• totalCount(ακέραιος): Συνολικός αριθμός θέσεων εργασίας που βρέθηκαν.
• jobs(πίνακας): Λίστα αντικειμένων θέσεων εργασίας που περιέχουν:
  • id(ακέραιος): Μοναδικό αναγνωριστικό δημοσίευσης θέσης εργασίας.
  • title(συμβολοσειρά): Τίτλος θέσης εργασίας.
  • location(συμβολοσειρά): Τοποθεσία θέσης εργασίας.
  • snippet(συμβολοσειρά): Σύντομο απόσπασμα περιγραφής που εμφανίζεται στα αποτελέσματα αναζήτησης.
  • salary(συμβολοσειρά): Εύρος μισθού σε μορφή {min} - {max} {currency}.
  • source(συμβολοσειρά): Πηγή της δημοσίευσης της θέσης εργασίας.
  • type(συμβολοσειρά): Τύπος απασχόλησης (π.χ. Πλήρης απασχόληση, Μερική απασχόληση).
  • link(συμβολοσειρά): Απευθείας URL προς τη δημοσίευση της θέσης εργασίας στο Jooble.
  • company(συμβολοσειρά): Όνομα εταιρείας.
  • updated(συμβολοσειρά): Χρονοσήμανση ISO της τελευταίας ενημέρωσης της θέσης εργασίας.

Παραδείγματα αιτήματος & απόκρισης JSON

Παράδειγμα ωφέλιμου φορτίου αιτήματος:

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

HTTP απόκριση & Κωδικοί σφάλματος

• 200 OK: Το αίτημα ήταν επιτυχές και επέστρεψε δεδομένα.
• 403 Access Denied: Μη έγκυρο ή λείπει το κλειδί API.
• 404 Not Found: Το τελικό σημείο ή ο πόρος που ζητήθηκε δεν υπάρχει.

Παραδείγματα υλοποίησης κώδικα

Μπορείτε να ενσωματώσετε το Jooble REST API χρησιμοποιώντας γλώσσες προγραμματισμού όπως PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby και άλλες. Έτοιμα προς χρήση αποσπάσματα κώδικα και οδηγοί υλοποίησης είναι διαθέσιμα στη Σελίδα τεκμηρίωσης Jooble API.