Paylocity API, insan kaynakları ve bordro yönetimi süreçlerini harici sistemlerle entegre etmek için sunulan RESTful bir web servisidir. OAuth 2.0 ile yetkilendirme yapar, JSON formatında veri alışverişi sağlar. API'nin v2 sürümü güncel özellikleri içerirken, v1 sürümü hala desteklenmekte ancak yeni özellikler eklenmemektedir. Paylocity, müşterilere özel istemci kimlik bilgileri ve veri şifreleme için genel anahtar sağlar. API, test ve üretim ortamları için ayrı uç noktalar sunar.
Hangi ihtiyaçlarda değerlendirilebilir?
- İnsan kaynakları ve bordro süreçlerini dijitalleştirmek isteyen kurumlar
- Mevcut İK sistemlerini Paylocity ile entegre etmek isteyen yazılım ekipleri
- Çalışan verilerini merkezi bir platformda yönetmek isteyen işletmeler
Yaygın kullanım alanları
Bordro Verilerinin Otomatik Senkronizasyonu
İK sisteminizdeki çalışan bilgilerini Paylocity API üzerinden bordro sistemine otomatik aktararak manuel veri girişini ortadan kaldırabilirsiniz.
Çalışan Self-Servis Uygulamaları
Çalışanların izin talepleri, maaş bordroları ve kişisel bilgilerini güncelleyebileceği bir portal geliştirmek için API'den yararlanabilirsiniz.
Raporlama ve Analiz Panelleri
Paylocity API'den alınan verilerle iş gücü, maliyet ve devamsızlık analizleri yapan özel raporlama panelleri oluşturabilirsiniz.
İncelenmesi gereken noktalar
- API, OAuth 2.0 ile yetkilendirme gerektirir; istemci kimlik bilgilerinin güvenli bir şekilde saklanması önemlidir.
- İstemci sırrı 365 gün geçerlidir ve yenilenmesi için e-posta bildirimleri gönderilir; bu süreç takip edilmelidir.
- Paylocity API, istek sayısına sınırlama getirebilir; yoğun kullanım senaryoları için bu limitler göz önünde bulundurulmalıdır.
WordPress.org
Kurulum ve geliştirme notları
Paylocity API kullanımı için öncelikle Paylocity'den istemci kimlik bilgileri (client id, secret) ve genel anahtar temin edilmelidir. API'ye erişim için OAuth 2.0 ile bearer token alınması gerekir. Test ortamı için ayrı bir uç nokta bulunmaktadır.
- 1Paylocity'den istemci kimlik bilgilerini ve genel anahtarı edinin.
- 2OAuth 2.0 token uç noktasına (test veya üretim) istek göndererek bearer token alın.
- 3API isteklerinde Authorization header'ına 'Bearer {token}' ekleyin.
- 4JSON formatında istek ve yanıtları işleyin.
Paylocity API ile geliştirme yaparken, API'nin sürüm farklılıklarını (v1 ve v2) dikkate almak ve Paylocity'nin sağladığı dokümantasyonu takip etmek önemlidir. API, RESTful yapıda olduğundan standart HTTP metodları kullanılır.
- OAuth 2.0 ile güvenli yetkilendirme
- JSON formatında veri alışverişi
- Hem test hem üretim ortamı için ayrı uç noktalar
- v1 ve v2 sürüm desteği
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
ZeplinGo olarak, Paylocity API entegrasyonunuzu ihtiyaçlarınıza göre analiz ediyor, kapsamı birlikte belirliyor ve web yazılım çözümleri geliştiriyoruz. API'nin sunduğu olanakları iş süreçlerinize uyarlayarak verimliliği artıracak çözümler tasarlıyoruz.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
Paylocity API hangi yetkilendirme yöntemini kullanır?
Paylocity API, OAuth 2.0 protokolünü kullanır. İstemci kimlik bilgileri ile token alınarak API isteklerinde bu token kullanılır.
Paylocity API'nin v1 ve v2 sürümleri arasındaki fark nedir?
v2 sürümü güncel özellikleri içerirken, v1 sürümü hala desteklenmekte ancak yeni özellikler eklenmemektedir. Geçiş ve farklar hakkında Paylocity ile iletişime geçilmesi önerilir.
Paylocity API için test ortamı var mı?
Evet, test ortamı için ayrı bir uç nokta bulunmaktadır: https://apisandbox.paylocity.com/IdentityServer/connect/token
