პლატფორმა
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-ის პროფილი ან ეძებს თუ არა სამსახურს.
ენდპოინტები
ქვემოთ მოცემული ცხრილი იმავე სიიდან იქმნება, რომლიდანაც API მარშრუტებს იღებს, ამიტომ ვერ გაიყრება. სტატუსი „live“ დღეს პასუხობს; „planned“ დაპროექტებულია და 501-ს პასუხობს, სანამ არ ამუშავდება.
| 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 | planned | ვაკანსიის გამოქვეყნება (მოდერაციაზე მიდის, როგორც საიტზე) |
PATCH | /jobs/{id} | jobs:write | planned | ვაკანსიის რედაქტირება |
POST | /jobs/{id}/close | jobs:write | planned | ვაკანსიის დახურვა |
POST | /jobs/{id}/bump | jobs:write | planned | ვაკანსიის აწევა (Pro) |
GET | /applications | applications:read | 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 | ჩანაწერის შეცვლა; ხელფასის, როლის, განყოფილების ცვლილება ისტორიაში იწერება |
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 | planned | კანდიდატისთვის პასუხი იმავე ჩატში, რაც საიტზე |
POST | /applications/{id}/interview | applications:write | planned | გასაუბრების დანიშვნა |
GET | /people | people:read | planned | თანამშრომლების ბარათები |
POST | /people | people:write | planned | თანამშრომლის დამატება |
GET | /people/{id} | people:read | planned | ერთი ბარათი (პირადი დეტალების გარეშე) |
GET | /leave/requests | people:read | planned | შვებულების თხოვნები |
POST | /leave/requests/{id}/decide | people:write | planned | შვებულების დადასტურება ან უარყოფა |
GET | /pay-runs | money:read | planned | ხელფასის გაანგარიშებები |
GET | /pay-runs/{month} | money:read | planned | ერთი თვის გაანგარიშება სტრიქონებით |
POST | /pay-runs/{month}/approve | money:write | planned | გაანგარიშების დადასტურება (ფაილები მზადდება; ფული არ მოძრაობს) |
GET | /rules | money:read | planned | წესები და განაკვეთები მათი დადასტურების სტატუსით |
GET | /keys | settings:write | planned | ამ კომპანიის გასაღებები (გასაღებების ჩათვლით, რომლებიც ამ გასაღებით არ იქმნება) |
GET | /webhooks | settings:write | planned | ვებჰუკების გამოწერები |