hirify
HIRIFY API · V1

Hirify-ı öz HR sisteminə qoş.

Vakansiyaları və namizəd mərhələlərini öz sistemində sinxron saxla.

BaşlaTezliklə
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"}'
Bu API aktiv inkişaf mərhələsindədir, endpoint adları, sahələr və limitlər xəbərdarlıq olmadan dəyişə bilər.

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.

BASEhttps://api.hirify.az/v1

Autentifikasiya

Hər sorğuda Bearer token göndər. Açarı ayarlar bölməsindən yaradacaqsan (tezliklə).

Authorization: Bearer hf_live_xxxxxxxxxxxxxxxx

Vakansiyalar

Vakansiya yarat, yenilə və siyahısına bax.

GET /vacanciesPOST /vacanciesPATCH /vacancies/{id}
titlestringrequired
categorystringe.g. data_analytics
citystringor remote
work_formatenumoffice · hybrid · remote
salaryobject{"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ş.

GET /vacancies/{id}/applicationsPATCH /applications/{id}

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.

sourcing· Müraciət qəbul olunduscreening· CV seçimiexam· Testvideo_interview· Müsahibədirector_review· Qısa siyahı / yekun görüşoffer· Təklifhired· İşə qəbulrejected

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əldi
application.stage_changedNamizədin mərhələsi dəyişdi
vacancy.publishedElan dərc olundu
vacancy.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 oldu
403İcazə yoxdur
404Tapılmadı
422Doğrulama xətası (errors massivinə bax)
429Sorğu limiti aşıldı

Sualın var?

Bizə yaz, yoxsa suallar bölməsinə bax.

Bizə yaz →

Sizi daxil olmuş vəziyyətdə saxlamaq və saytın necə istifadə olunduğunu anlamaq üçün kukilərdən istifadə edirik. Ətraflı öyrənin