Ajanlarınız için API

Kimin için

Bir asistanın rutini yapmasını isteyen şirketler için: "bir depo vardiya amirine ne teklif edelim" sorusunu yanıtlamak, çok uzun süredir bekleyen adayları listelemek, kısa bir brifingden ilan yayınlamak, bir insan kontrolleri okuduktan sonra bordroyu onaylamak. API, sayfaların kullandığı aynı hizmet katmanıdır; bu yüzden sistemin yaptığı her şeye aynı kurallar ve aynı rol sınırlarıyla ulaşılabilecek.

Aynı zamanda "bunu otomatikleştirebilir miyim" sorusunun dürüst yanıtıdır: salt okunur uç noktalar şimdi yayında; yazma uç noktaları "planned" durumuyla listelenir ve sunulana kadar 501 yanıtı verir; böylece bir ajan asla tahmin yürütmez.

Anahtar üretmek

1. Ayarlar › API anahtarlarını açın. Yalnızca şirket sahibi üretebilir; önce taze bir ikinci kilit istenir.
2. Anahtara yaptığı işe göre ad verin ("Claude ajanı", "bordro betiği"), işi yapan en dar kapsamları seçin ve ne zaman dolacağını belirleyin.
3. Riskleri okuyun ve onayı işaretleyin. Anahtar bir kez gösterilir; ajanınızın gizli deposuna kopyalayın, başka hiçbir yere değil.
4. Artık gerekmediği anda aynı sayfadan iptal edin. İptal anında olur.

Demoda herkes bir demo anahtarı (fjhr_demo_…) üretebilir. Yalnızca demo şirketinizde çalışır ve onunla birlikte silinir.

Riskler, açıkça

• Bir anahtar şirketin şifresidir. Elinde tutan herkes, ikinci kilit olmadan kapsamlarının izin verdiği her şeyi yapabilir.
• Bir ajan sizin adınıza hareket eder. Yanlış bir talimat bir ilanı kapatabilir, bir adayı reddedebilir ya da bir kaydı değiştirebilir. Okuma kapsamlarıyla başlayın; ajan hak ettiğinde yazma kapsamları ekleyin.
• Bir anahtarı asla herkese açık bir sohbete, bir depoya ya da başkasının okuyabileceği bir komuta yapıştırmayın. Şüphede döndürün.
• Her çağrı anahtar, rota, durum ve zamanla kaydedilir. Sahip günlüğü aynı sayfada okur.

Kapsamlar

• market:read: maaş aralıkları ve işe alım zorluğu.
• company:read: şirket, Ana sayfa ve sayılar.
• jobs:read ve jobs:write: ilanları okuma, yayınlama, düzenleme, kapatma ve öne çıkarma.
• applications:read ve applications:write: başvuruları ve puanları okuma; aşama değiştirme, yanıtlama, görüşme planlama.
• people:read ve people:write: özel bilgiler olmadan çalışan kayıtları; kişi ekleme ve değiştirme, izin kararı.
• money:read ve money:write: bordrolar ve kurallar; bordro onaylama (dosyalar hazırlanır; para hareket etmez).
• settings:write: webhook'lar ve ayarlar. Anahtarların kendisi bir anahtarla asla üretilemez ya da değiştirilemez.
• all: yukarıdakilerin tümü.

Çağırmak

Temel adres https://hr.findjobs.ge/hr/api/v1. Her istekte anahtarı Authorization: Bearer fjhr_live_… olarak gönderin. Yanıtlar JSON'dur. API'nin konuştuğu yerlerde o dilde özetler almak için ?hl=ka, ru ya da tr ekleyin.

Sınırlar: anahtar başına dakikada 60 çağrı ve 20 yazma. 429, saniye cinsinden Retry-After taşır.

Hatalar sabit bir kod ve bir cümleyle JSON'dur: missing_key, invalid_key, scope, rate_limited, not_yet (tasarlandı, sunulmuyor), not_found, server_error ve bir belge bağlantısı.

Bir LLM ajanı için

1. Ajana https://hr.findjobs.ge/hr/api/v1/llms.txt adresini verin: API'yi, sınırları ve kuralları düz metinle anlatır.
2. Araç üretmesi için https://hr.findjobs.ge/hr/api/v1/openapi.json adresindeki OpenAPI belgesini verin.
3. Anahtarı ajanın gizli deposunda saklayın, asla komutta değil.
4. Yapamayacağını denemesin diye anahtarın hangi kapsamlara sahip olduğunu söyleyin.

Örnek: curl -H "Authorization: Bearer $KEY" "https://hr.findjobs.ge/hr/api/v1/market/pay-check?city=tbilisi&family=sales&offer=1200"

Bir anahtarın asla yapamayacakları

• Başka bir şirketin verisini ya da şirketin findjobs.ge'de zaten gördüğünün ötesinde herhangi bir iş arayanın özel verisini okumak.
• Para taşımak, bir bankaya giriş yapmak ya da Gelir İdaresi'ne beyan sunmak.
• Anahtar üretmek ya da değiştirmek, ikinci kilidi zayıflatmak.
• Bir çalışanın findjobs profili olup olmadığını ya da başka yere başvurup başvurmadığını öğrenmek.

MCP sunucusu

Aynı API, https://hr.findjobs.ge/hr/api/mcp adresinde bir Model Context Protocol sunucusu olarak sunulur (Streamable HTTP). Claude, ChatGPT, Cursor ya da herhangi bir MCP ana bilgisayarında şirket anahtarını bearer belirteci olarak kullanarak uzak MCP sunucusu olarak ekleyin; her uç nokta aynı kayıt defterinden, aynı kapsamlar, sınırlar ve günlükle bir araç olarak görünür.

Uç noktalar

Aşağıdaki tablo API'nin yönlendirme yaptığı aynı listeden üretilir; bu yüzden ayrışamaz. Listelenen her uç nokta bugün yanıt verir; kapsamlar bir anahtarın neler yapabileceğini söyler.