პლატფორმა
API თქვენი აგენტებისთვის
კომპანიის მიერ შექმნილი გასაღები თქვენს აგენტებს (Claude-ს ან ნებისმიერ სხვას) და სკრიპტებს აძლევს HR Suite-ისა და findjobs.ge-ის ანგარიშის წაკითხვისა და, ენდპოინტების ამუშავებისთანავე, მართვის საშუალებას. უფლებებით შეზღუდული, ჩაწერილი, გაუქმებადი და მანქანურად აღწერილი, რომ აგენტმა თავად აღმოაჩინოს.
ვისთვისაა
კომპანიებისთვის, რომლებსაც სურთ ასისტენტმა რუტინა აკეთოს: უპასუხოს „რა შევთავაზოთ საწყობის ცვლის უფროსს“, ჩამოთვალოს დიდხანს მომლოდინე კანდიდატები, მოკლე აღწერიდან ვაკანსია გამოაქვეყნოს, გაანგარიშება დაადასტუროს მას შემდეგ, რაც ადამიანი შემოწმებებს წაიკითხავს. API იგივე სერვისული ფენაა, რასაც გვერდები იყენებენ, ამიტომ ყველაფერი, რასაც სისტემა აკეთებს, ხელმისაწვდომი იქნება იმავე წესებითა და როლების შეზღუდვებით.
ეს არის პატიოსანი პასუხი კითხვაზე „შემიძლია ეს ავტომატიზირება“: წასაკითხი ენდპოინტები ახლა მუშაობს; ჩასაწერი ენდპოინტები ჩამოთვლილია სტატუსით „planned“ და 501-ს პასუხობს, სანამ არ ამუშავდება, ასე რომ აგენტი არასდროს ვარაუდობს.
გასაღების შექმნა
- გახსენით პარამეტრები › API გასაღებები. შექმნა მხოლოდ კომპანიის მფლობელს შეუძლია; ჯერ ახალი მეორე საკეტი მოგეთხოვებათ.
- დაარქვით გასაღებს სახელი იმის მიხედვით, რას აკეთებს („Claude აგენტი“, „ხელფასის სკრიპტი“), აირჩიეთ ყველაზე ვიწრო უფლებები, რაც საქმეს აკეთებს, და აირჩიეთ ვადა.
- წაიკითხეთ რისკები და მონიშნეთ თანხმობა. გასაღები ერთხელ ჩანს; დააკოპირეთ აგენტის საიდუმლოებების საცავში და სხვაგან არსად.
- გააუქმეთ იმავე გვერდიდან, როგორც კი აღარ დაგჭირდებათ. გაუქმება მყისიერია.
დემოში ყველას შეუძლია დემო გასაღების შექმნა (fjhr_demo_…). ის მხოლოდ თქვენს დემო კომპანიაზე მოქმედებს და მასთან ერთად ქრება.
რისკები, პირდაპირ
- გასაღები კომპანიის პაროლია. ვისაც ის აქვს, ყველაფერს შეუძლია, რასაც მისი უფლებები უშვებს, მეორე საკეტის გარეშე.
- აგენტი თქვენი სახელით მოქმედებს. არასწორ ინსტრუქციას შეუძლია ვაკანსია დახუროს, კანდიდატი უარყოს ან ბარათი შეცვალოს. დაიწყეთ წასაკითხი უფლებებით; ჩასაწერი დაამატეთ, როცა აგენტი ამას დაიმსახურებს.
- არასდროს ჩასვათ გასაღები საჯარო ჩატში, რეპოზიტორიაში ან პრომპტში, რომელსაც სხვა წაიკითხავს. ეჭვის შემთხვევაში შეცვალეთ.
- ყველა გამოძახება იწერება გასაღებით, მარშრუტით, სტატუსითა და დროით. მფლობელი ჟურნალს იმავე გვერდზე კითხულობს.
უფლებები
- market:read: ანაზღაურების დიაპაზონები და დაქირავების სირთულე.
- company:read: კომპანია, მთავარი და რიცხვები.
- jobs:read და jobs:write: ვაკანსიების წაკითხვა, გამოქვეყნება, რედაქტირება, დახურვა და აწევა.
- applications:read და applications:write: განაცხადებისა და ქულების წაკითხვა; ეტაპების შეცვლა, პასუხი, გასაუბრების დანიშვნა.
- people:read და people:write: თანამშრომლის ბარათები პირადი დეტალების გარეშე; ადამიანების დამატება და შეცვლა, შვებულების გადაწყვეტა.
- money:read და money:write: გაანგარიშებები და წესები; გაანგარიშების დადასტურება (ფაილები მზადდება; ფული არ მოძრაობს).
- settings:write: ვებჰუკები და პარამეტრები. თავად გასაღებების შექმნა ან შეცვლა გასაღებით არასდროს შეიძლება.
- all: ყველაფერი ზემოთ.
გამოძახება
საბაზისო მისამართი https://hr.findjobs.ge/hr/api/v1. გასაღები ყველა მოთხოვნაში გაგზავნეთ, როგორც Authorization: Bearer fjhr_live_…. პასუხები JSON-ია. დაამატეთ ?hl=ka, ru ან tr, რომ შეჯამებები იმ ენაზე მიიღოთ, სადაც API ლაპარაკობს.
ლიმიტები: 60 გამოძახება წუთში და 20 ჩანაწერი წუთში თითო გასაღებზე. 429 Retry-After-ს წამებში ატარებს.
შეცდომები JSON-ია სტაბილური კოდითა და წინადადებით: missing_key, invalid_key, scope, rate_limited, not_yet (დაპროექტებული, ჯერ არ ემსახურება), not_found, server_error, და დოკუმენტაციის ბმულით.
LLM აგენტისთვის
- მიეცით აგენტს https://hr.findjobs.ge/hr/api/v1/llms.txt: ის მარტივი ტექსტით აღწერს API-ს, ლიმიტებსა და წესებს.
- მიეცით OpenAPI დოკუმენტი https://hr.findjobs.ge/hr/api/v1/openapi.json ხელსაწყოების გენერირებისთვის.
- შეინახეთ გასაღები აგენტის საიდუმლოებების საცავში და არასდროს პრომპტში.
- უთხარით, რა უფლებები აქვს გასაღებს, რომ არ სცადოს ის, რაც არ შეუძლია.
მაგალითი: curl -H "Authorization: Bearer $KEY" "https://hr.findjobs.ge/hr/api/v1/market/pay-check?city=tbilisi&family=sales&offer=1200"
რას ვერასდროს გააკეთებს გასაღები
- სხვა კომპანიის მონაცემების ან რომელიმე კანდიდატის პირადი მონაცემების წაკითხვა იმის მიღმა, რასაც კომპანია findjobs.ge-ზე უკვე ხედავს.
- ფულის გადატანა, ბანკში შესვლა ან შემოსავლების სამსახურში წარდგენა.
- გასაღებების შექმნა ან შეცვლა, ან მეორე საკეტის შესუსტება.
- იმის გაგება, აქვს თუ არა თანამშრომელს findjobs-ის პროფილი ან ეძებს თუ არა სამსახურს.
MCP სერვერი
იგივე API Model Context Protocol სერვერად მიეწოდება https://hr.findjobs.ge/hr/api/mcp-ზე (Streamable HTTP). დაამატეთ დისტანციურ MCP სერვერად Claude-ში, ChatGPT-ში, Cursor-ში ან ნებისმიერ MCP ჰოსტში კომპანიის გასაღებით, როგორც bearer ტოკენით; ყოველი ენდპოინტი ხელსაწყოდ ჩნდება, იმავე რეესტრიდან, იმავე სკოუპებით, ლიმიტებითა და ჟურნალით.
ენდპოინტები
ქვემოთ მოცემული ცხრილი იმავე სიიდან იქმნება, რომლიდანაც API მარშრუტებს აკეთებს, ამიტომ ვერ გაითიშება. ყველა ჩამოთვლილი ენდპოინტი დღეს პასუხობს; სკოუპები ამბობს, რა შეუძლია გასაღებს.
| hr.findjobs.ge/hr/api/v1 | scope | status | ||
|---|---|---|---|---|
GET | /me | company:read | live | ვინ ხართ: კომპანია, გასაღების უფლებები და ლიმიტები |
GET | /home | company:read | live | მთავარი გვერდის რიგი: რას სჭირდება გადაწყვეტილება |
GET | /market/pay-check | market:read | live | რას იხდის სფერო ქალაქში: ქვედა მეოთხედი, შუა, ზედა მეოთხედი |
GET | /market/difficulty | market:read | live | დაქირავების სირთულე ქალაქში: ვაკანსია ერთ კანდიდატზე, დღეები |
GET | /market/radar | market:read | live | კონკურენტების რადარი: თქვენი ღია როლები, კონკურენტების განცხადებები, ხელფასები, ვინ ეძებს ყველაზე მეტს |
GET | /market/survey | market:read | live | ხელფასების გამოკითხვის ჯგუფები ქალაქში: კომპანიები, ადამიანები, რეალური ხელფასის შუა |
POST | /market/survey | money:write | live | თქვენი კომპანიის ხელფასის ჩანაწერი სფეროზე: ადამიანები, დაბალი, შუა, მაღალი |
GET | /jobs | jobs:read | live | თქვენი ვაკანსიები findjobs.ge-ზე |
GET | /jobs/{id} | jobs:read | live | ერთი ვაკანსია სრულად |
GET | /jobs/{id}/doctor | jobs:read | live | განცხადების ექიმი: ქულა 0–100, ყველა შემოწმება და გასასწორებელი |
POST | /jobs | jobs:write | live | ვაკანსიის გამოქვეყნება (მოდერაციაზე მიდის, როგორც საიტზე) |
PATCH | /jobs/{id} | jobs:write | live | ვაკანსიის რედაქტირება |
POST | /jobs/{id}/close | jobs:write | live | ვაკანსიის დახურვა |
POST | /jobs/{id}/bump | jobs:write | live | ვაკანსიის აწევა (Pro) |
GET | /applications | applications:read | live | განაცხადები თქვენს ვაკანსიებზე |
POST | /applications | applications:write | live | განაცხადი თქვენი საიტიდან: პაიპლაინში და ინბოქსში, კანდიდატს წერილი არ მიდის |
GET | /applications/{id} | applications:read | live | ერთი განაცხადი: შეტყობინება, პასუხები, ქულები |
GET | /people | people:read | live | თანამშრომლების ჩანაწერები (პირადი ველების გარეშე) |
POST | /people | people:write | live | ახალი ჩანაწერი |
GET | /people/{id} | people:read | live | ერთი ჩანაწერი ისტორიით და შვებულების ბალანსით |
PATCH | /people/{id} | people:write | live | ჩანაწერის შეცვლა; ხელფასის, როლის, განყოფილების ცვლილება ისტორიაში იწერება |
GET | /people/{id}/earnings | people:read | live | გარედან მოხსენებული შემოსავალი თვეების მიხედვით |
POST | /people/{id}/earnings | people:write | live | თვის შემოსავლის მოხსენება სამუშაოზე ანაზღაურებული თანამშრომლისთვის (იგივე თვე და წყარო → განახლება) |
POST | /people/{id}/leaving | people:write | live | ბოლო დღის დაყენება |
GET | /timeoff | people:read | live | შვებულება: მოთხოვნილი და დამტკიცებული |
POST | /timeoff | people:write | live | შვებულების დამატება (მოთხოვნა ან დამტკიცებული) |
POST | /timeoff/{id}/decide | people:write | live | გადაწყვეტილება: approved, declined, cancelled |
GET | /payrun | money:read | live | თვის გაანგარიშება: სტრიქონები და ჯამები |
POST | /payrun/{period}/approve | money:write | live | თვის დამტკიცება (სნეპშოტი ჯერ იღება) |
GET | /payrun/{period}/file | money:read | live | დამტკიცებული თვის ფაილი: oris, fina, 1c, excel, journal, tbc, bog, liberty, bank-excel, rsge |
GET | /rules | money:read | live | წესები და განაკვეთები, დამადასტურებლით |
POST | /rules/{id}/confirm | money:write | live | წესის დადასტურება სახელით |
GET | /snapshots | settings:write | live | სნეპშოტების სია |
POST | /snapshots | settings:write | live | სნეპშოტის გადაღება ახლა |
POST | /snapshots/{id}/restore | settings:write | live | აღდგენა სნეპშოტიდან (ჯერ ახლანდელის სნეპშოტი იღება) |
GET | /pipeline | applications:read | live | ერთი ვაკანსიის დაფა: ეტაპები, ბარათები, პასუხის საათი, შეფასების ფურცლები |
POST | /applications/{id}/status | applications:write | live | ბარათის გადატანა ეტაპზე: seen, shortlisted, hold, hired, rejected |
POST | /applications/{id}/scorecard | applications:write | live | შეფასების ფურცლის შენახვა: ოთხი ქულა 1–5 და შენიშვნა |
POST | /applications/{id}/message | applications:write | live | კანდიდატისთვის პასუხი იმავე ჩატში, რაც საიტზე |
POST | /applications/{id}/interview | applications:write | live | გასაუბრების დანიშვნა |
GET | /keys | settings:write | live | ამ კომპანიის გასაღებები (გასაღებების ჩათვლით, რომლებიც ამ გასაღებით არ იქმნება) |
GET | /webhooks | settings:write | live | ვებჰუკების გამოწერები |
GET | /shifts | people:read | live | ცვლების კვირა: ცვლები, ღია, გაცვლები, დაფარვა |
POST | /shifts | people:write | live | ცვლის დამატება (person_id-ის გარეშე = ღია) |
POST | /shifts/{id}/assign | people:write | live | ცვლის მიცემა ადამიანისთვის, ან გახსნა |
DELETE | /shifts/{id} | people:write | live | ცვლის წაშლა |
GET | /reviews | people:read | live | შეფასების რაუნდი: ქულები, საშუალოები, მიზნები |
POST | /reviews/open | people:write | live | რაუნდის გახსნა ყველასთვის ან განყოფილებისთვის |
POST | /reviews/{id}/score | people:write | live | ქულების შენახვა (მენეჯერი, ან side: self) |
POST | /reviews/{id}/goals | people:write | live | მიზნების შენახვა |
GET | /pay-vs-market | people:read | live | თითოეულის ხელფასი ქალაქის ბაზართან |
GET | /permits | people:read | live | ნებართვის საქმეები |
POST | /permits | people:write | live | საქმის გახსნა |
POST | /permits/{id}/move | people:write | live | ეტაპის, თარიღის, დოკუმენტის განახლება |
GET | /leaving | people:read | live | წამსვლელები: სია, ანგარიშსწორება, ცნობა |
POST | /leaving/{id}/tick | people:write | live | სიის პუნქტის მონიშვნა |
POST | /leaving/{id}/settle | money:write | live | საბოლოო ანგარიშსწორების გამოთვლა და შენახვა |
GET | /onboarding | people:read | live | ახალი თანამშრომლები: სია, ხელშეკრულების სტატუსი |
POST | /onboarding | people:write | live | ახალი თანამშრომლის დამატება |
POST | /onboarding/{id}/tick | people:write | live | სიის პუნქტის მონიშვნა |
POST | /onboarding/{id}/contract | people:write | live | ხელშეკრულების გაგზავნა კოდით |
POST | /onboarding/{id}/record | people:write | live | ჩანაწერის შექმნა სტრიქონიდან |
GET | /automations | settings:write | live | ავტომატიზაციების ჩამრთველები და ჟურნალი |
POST | /automations/run | settings:write | live | ამ კომპანიის ავტომატიზაციების ახლავე გაშვება |
POST | /automations/{key} | settings:write | live | ჩამრთველის ჩართვა/გამორთვა |
GET | /connections | settings:write | live | პროგრამა, ბანკი, კალენდრის არხი |
PATCH | /connections | settings:write | live | კავშირების შეცვლა |
POST | /webhooks | settings:write | live | ვებჰუკის დამატება (საიდუმლო ერთხელ ბრუნდება) |
DELETE | /webhooks/{id} | settings:write | live | ვებჰუკის წაშლა |
GET | /accountants | money:read | live | ბუღალტრები კარით |
POST | /accountants | money:write | live | ბუღალტრის დამატება და მოწვევა |
DELETE | /accountants/{id} | money:write | live | ბუღალტრის წაშლა |
GET | /reports/twelve-months | people:read | live | თორმეტი თვე: ადამიანები, გაანგარიშებები, დასვენება, დაქირავება |