Hirify-ı öz HR sisteminə qoş.
Vakansiyaları və namizəd mərhələlərini öz sistemində sinxron saxla.
curl -X POST https://api.hirify.az/v1/vacancies \
-H "Authorization: Bearer hf_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"title":"Data Analyst","city":"Bakı","work_format":"hybrid"}'Giriş
Hirify API sənə vakansiya yaratmağa və müraciət mərhələlərini oxumağa imkan verir. Bütün sorğular JSON formatındadır.
Autentifikasiya
Hər sorğuda Bearer token göndər. Açarı ayarlar bölməsindən yaradacaqsan (tezliklə).
Authorization: Bearer hf_live_xxxxxxxxxxxxxxxxVakansiyalar
Vakansiya yarat, yenilə və siyahısına bax.
titlestringrequiredcategorystringe.g. data_analyticscitystringor remotework_formatenumoffice · hybrid · remotesalaryobject{"min":1500,"max":2200,"currency":"AZN","visible":true}Müraciətlər
Bir vakansiyanın müraciətlərini oxu və mərhələsini dəyiş.
Mərhələlər
Hər müraciət aşağıdakı real mərhələ ardıcıllığı ilə irəliləyir. “rejected” xətti tərk edən ayrıca vəziyyətdir, xətti davam etdirmir.
Webhook-lar
Hadisə baş verəndə sənin ünvanına imzalanmış sorğu göndərilir (X-Hirify-Signature, HMAC-SHA256).
application.createdYeni müraciət gəldiapplication.stage_changedNamizədin mərhələsi dəyişdivacancy.publishedElan dərc olunduvacancy.closedElan bağlandıLimitlər
Hər API açarı üçün dəqiqədə sorğu limiti var (dəqiq rəqəm təsdiqlənəndən sonra göstəriləcək). Limit aşılanda 429 və Retry-After header qaytarılır.
Xəta kodları
Standart HTTP status kodları istifadə olunur.
400Yanlış sorğu formatı401Autentifikasiya uğursuz oldu403İcazə yoxdur404Tapılmadı422Doğrulama xətası (errors massivinə bax)429Sorğu limiti aşıldıSualın var?
Bizə yaz, yoxsa suallar bölməsinə bax.
