REST API anahtarınızla bağlantı kurduktan sonra endpoint, yanıt parametreleri ve olası kod hataları hakkında bilgi bulabilirsiniz. Bağlantı kurmadıysanız, bu rehberdeki adımları takip edin.
API Anahtarını Nasıl Alabilirsiniz?
Web sitesine kaydolun: https://tr.jooble.org/api/about
Kayıt yaptıktan sonra, sizin için oluşturulan API anahtarını kopyalayıp saklayın.
Endpoints
Aşağıda, istediğiniz verileri almak için Jooble REST API ile etkileşimde bulunmak üzere kullanabileceğiniz mevcut endpoint'leri bulabilirsiniz.
İstek Parametreleri:
POST /api/{api_Key}
- keywords: İş ilanlarını aramak için anahtar kelimeler.
- location: İş ilanlarını aramak için konum.
- radius (isteğe bağlı): Arama yarıçapı, kilometreye çevrildi (tür: string).
- salary (isteğe bağlı): İş araması için minimum maaş (tür: integer).
- page (isteğe bağlı): Arama sonuçlarının sayfa numarası.
- ResultOnPage (isteğe bağlı): Her sayfada gösterilen iş ilanı sayısı.
- SearchMode (isteğe bağlı): Arama modu, varsayılan 0.
- companysearch (isteğe bağlı):
- true – İş ilanında şirket adında anahtar kelimeleri arayın.
- false &nd ash; İş ilanında iş başlığı veya açıklamasında anahtar kelimeleri arayın.
Yanıt Parametreleri:
- totalCount: Arama isteğinde bulunan toplam iş ilanı sayısı.
- jobs: Arama kriterlerine uyan iş ilanlarının listesi.
- title: İş başlığı.
- location: İş konumu.
- snippet: Arama sonuçlarında görüntülenen iş açıklamasının parçası.
- salary: Maaş aralığı {job.salary_val1} - {job.salary_val2} {currency} formatında.
- source: İş ilanının kaynağı.
- type: İş türü (tam zamanlı, yarım zamanlı, vb.).
- link: İş ilanına giden URL.
- company: Şirket adı.
- updated: İş ilanının son güncellenme tarihi ve saati.
- id: İş ilanının benzersiz kimliği.
JSON Örnek İstek
POST https://jooble.org/api/{api_Key}
{
"keywords": "Satış Yöneticisi, Yönetici",
"location": "Kyiv",
"radius": "80",
"page": "1",
"companysearch": "false"
}
Başarılı Yanıt: 200 OK { "totalCount": 1, "jobs": [ { "title": "Satış Yöneticisi", "location": "Kyiv", "snippet": "Bu, ekibimize katılmak için harika bir fırsat...", "salary": "17,600 UAH", "source": "jooble", "type": "Tam Zamanlı", "link": "https://tr.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000", "id": 1234567890 } ] }
Hata Yanıtları:
403: Erişim reddedildi – Geçersiz API anahtarı.
404: Bulunamadı – İstenen endpoint veya kaynak mevcut değil.
Kodda Jooble API'nin Kullanım Örneği
Jooble API'sini PHP, JavaScript, Ruby, C# (.NET 4 veya sonrası), Python 3.5 veya Python 2.7 kullanarak uygulayabilirsiniz. Her dil için ayrıntılı kod örnekleri Jooble API hakkında sayfasında bulunabilir, bunu programcıya gösterin.
Jooble REST API Dokümantasyonu