API Sənədləri

Shifton API ilə əlaqə və iş

Shifton API platformanın bütün əsas xüsusiyyətlərinə giriş imkanı verir — cədvəl idarəçiliyindən tutmuş xarici HR, əməkhaqqı, və analitika sistemləri ilə inteqrasiyalara qədər..
API vasitəsilə siz prosesləri avtomatlaşdıra və Shifton-u şirkətinizin daxili xidmətləri ilə əlaqələndirə bilərsiniz.


API Sənədləri

Sənədlərimizin iki versiyasını dəstəkləyirik:


Başlanğıc

API Açarı Əldə Etmə

Shifton platformasında şirkətinizin ayarlarında bir API açarı.
Başlıq vasitəsilə təsdiq edilir:

Authorization: Bearer {your_api_key}

İlk Sorğunuzu Edin

Məsələn, əməkdaşların siyahısını almaq üçün:

GET /api/v1/employees
Host: api2.shifton.com
Authorization: Bearer {your_api_key}

Nümunə cavabı:

{
"data": [
{
"id": 101,
"name": "Alice Johnson",
"position": "HR Manager"
},
{
"id": 102,
"name": "Bob Smith",
"position": "Cashier"
}
]
}

API-ni İş Proseslərinizə İntegrasiya Edin

  • Avtomatik olaraq növbələr yaradın və dəyişdirin

  • Tətil və xəstəlik izni sorğularını idarə edin

  • Məlumatı əməkhaqqı sistemlərinə ixrac edin

  • Xüsusi tablolar və hesabatlar hazırlayın


Əsas API İmkanları

  • İşçilər – əlavə et, redaktə et və rolları idarə et

  • Cədvəllər – növbələr yarat, dəyişdir, iş planla

  • İstirahət və Məzuniyyətlər – məzuniyyət və xəstəlik izini sorğularını idarə et

  • Hesabat – vaxt, əmək haqqı və iştirak məlumatlarını ixrac et


Xəta Kodları

Shifton API standartHTTP status kodlarından istifadə edir:

  • 200 — Uğurlu sorğu

  • 201 — Obyekt uğurla yaradıldı

  • 400 — Yanlış parametrlər

  • 401 — İcazə səhvi (etibarsız API açarı)

  • 403 — Giriş qadağandır

  • 404 — Resurs tapılmadı

  • 500 — Server xətası


İstifadə Tipsləri

  • Həmişə yeni API versiyasından yeni inteqrasiyalar üçün istifadə edin

  • İstifadə edin Postman və ya curl test üçün

  • Həddən artıq yüklənməməsi üçün məhdudiyyətlərə riayət edin blo/ada düşməmək üçün

  • Hələ də köhnə sənədlərdən asılı olan inteqrasiyaları yeniləyin


Bu yazını paylaşın