Geliştiriciler
REST API Referansı
OnySoft HR mobil uygulaması da aynı API'yi kullanır. Kimlik doğrulama Bearer anahtarıyla yapılır, yanıtlar JSON'dur.
Erişim: Anahtar,
POST /api/v1/auth/giris ucundan kullanıcı
bilgileriyle alınır ve tüm isteklerde Authorization: Bearer <anahtar>
başlığıyla gönderilir; taban adres https://ik.onysoft.com.tr.
Sunucudan sunucuya kurumsal entegrasyon için bizimle görüşün.
Kimlik ve oturum
POST
/api/v1/auth/giris
E-posta ve parola ile giriş; erişim ve yenileme anahtarı döner
POST
/api/v1/auth/2fa
İki adımlı doğrulama kodunun onayı
POST
/api/v1/auth/yenile
Erişim anahtarını yenileme anahtarıyla tazeleme
POST
/api/v1/auth/cikis
Oturumu kapatma
GET
/api/v1/ben
Oturumdaki kullanıcının profili, rolü ve firma bilgisi
Personel (self-servis)
GET
/api/v1/personel/ozet
Ana ekran özeti: bugünkü durum, izin bakiyesi, son bordro
GET
/api/v1/personel/devam
Bugünün giriş-çıkış kayıtları, mesai penceresi ve saha sorusu
POST
/api/v1/personel/devam
Giriş ya da çıkış kaydı (GPS koordinatı veya QR ile)
POST
/api/v1/personel/devam/saha
Saha görevi sorusuna yanıt: görevdeyim / işi bitirdim
GET
/api/v1/personel/izinler
İzin talepleri ve bakiye
POST
/api/v1/personel/izinler
Yeni izin talebi (tam gün ya da saatlik)
GET
/api/v1/personel/bordrolar
Yayımlanmış bordro listesi
GET
/api/v1/personel/bordrolar/{id}/pdf
Bordronun PDF çıktısı
GET
/api/v1/personel/belgeler
Özlük belgeleri ve indirme bağlantıları
İK yöneticisi
GET
/api/v1/ik/ozet
Firma özeti: içeride, izinli, bekleyen talep, saha yanıtı bekleyen
GET
/api/v1/ik/personeller
Personel listesi
GET
/api/v1/ik/devam
Gün bazında devam tablosu ve saha görevleri
POST
/api/v1/ik/devam/saha
Saha görevini İK olarak işaretleme
GET
/api/v1/ik/izinler
İzin talepleri (bekleyen, onaylanan, reddedilen)
POST
/api/v1/ik/izinler/{id}/onayla
İzin talebini onaylama
POST
/api/v1/ik/izinler/{id}/reddet
İzin talebini gerekçesiyle reddetme
Ortak
GET
/api/v1/surum
İstemci sürüm kapısı: en düşük desteklenen sürüm ve mağaza bağlantıları
GET
/api/v1/firmalar
Çoklu firma yetkisi olan kullanıcının firmaları
POST
/api/v1/firma-sec
Aktif firmayı değiştirme
GET
/api/v1/bildirimler
Bildirim listesi ve okunmamış sayısı
GET
/api/v1/saglik
Servis sağlık kontrolü
Hız sınırı, sayfalama ve hata kodları için bizimle iletişime geçin; entegrasyon dokümanını paylaşalım.