ایچ آر اوپن API سے دوسرے سسٹم جوڑیں

ایچ آر اوپن API کسی دوسرے سسٹم کو آپ کی بنائی ہوئی کلید سے آپ کے لوگ، حاضری، چھٹیاں اور حتمی پے رول پڑھنے، اور پنچ بھیجنے دیتا ہے۔ ایچ آر ویب ہکس اس سسٹم کو بتاتے ہیں کہ کب کچھ ہوا۔

شروع کرنے سے پہلے

• آپ کا مالک ہونا ضروری ہے۔ منیجر کلیدیں نہیں بنا سکتے، چاہے ان کے پاس ایچ آر کا ہر اختیار ہو۔
• ایچ آر چالو ہو۔

کلید بنائیں

1. ایچ آر ← ایچ آر ترتیب کھولیں اور سیلف سروس اور ٹیم میں HR اوپن API منتخب کریں۔
2. اوپن API آن ہے پر نشان لگائیں اور محفوظ کریں منتخب کریں۔ صفحہ بنیادی پتہ دکھاتا ہے۔
3. کلید بنائیں کے نیچے کس کے لیے لکھیں (مثلاً "پے رول بیورو")۔
4. اجازتیں کے نیچے صرف اس پر نشان لگائیں جو سسٹم کو چاہیے: لوگ پڑھیں، حاضری پڑھیں، پنچ بھیجیں، چھٹی پڑھیں، حتمی پے رول پڑھیں، ویب ہکس منظم کریں۔
5. کلید بنائیں منتخب کریں۔
6. کلید ابھی کاپی کریں اور دوسرے سسٹم کو دیں۔ یہ ایک ہی بار دکھائی جاتی ہے؛ Kluvan صرف اس کا ہیش رکھتا ہے۔

ویب ہک شامل کریں

1. ویب ہک شامل کریں کے نیچے اپنے سسٹم کا URL لکھیں (یہ https سے شروع ہونا چاہیے)۔
2. ایونٹس پر نشان لگائیں: employee.created، employee.left، punch.recorded، leave.approved اور payroll.paid۔ شروع میں سب پر نشان لگا ہوتا ہے۔
3. شامل کریں منتخب کریں اور دستخط کا خفیہ کوڈ کاپی کریں، جو ایک ہی بار دکھایا جاتا ہے۔
4. ترسیلات میں دیکھیں کہ کیا بھیجا گیا، اس کی حیثیت اور کوششوں کی تعداد۔

جاننے کی باتیں

• الگ کلیدیں۔ ایچ آر کی کلیدیں اپنا الگ نظام ہیں، Kluvan کی کسی بھی دوسری API کلید سے الگ، اور یہ صرف آپ کے ادارے کے ایچ آر ڈیٹا تک پہنچتی ہیں۔
• کلید کبھی بینک کی تفصیلات، دستاویزات یا بایومیٹرک ڈیٹا نہیں پڑھتی۔ حتمی پے رول پڑھیں صرف ادا شدہ رن واپس کرتا ہے، کبھی مسودے نہیں، اور کوئی IBAN یا اکاؤنٹ نمبر نہیں۔
• کسی کلید کو فوراً روکنے کے لیے منسوخ کریں منتخب کریں۔ فہرست دکھاتی ہے کہ ہر کلید آخری بار کب استعمال ہوئی اور اس نے کتنی کالز کیں۔
• ایک کلید ایک سیکنڈ میں 10 کالز کر سکتی ہے، مختصر وقفوں میں 60 تک۔ مانگی گئی مدت زیادہ سے زیادہ 92 دن ہو سکتی ہے۔
• API سے بھیجا گیا پنچ درستی کے طور پر شامل ہوتا ہے، اور لکھنے والے کے طور پر کلید کا نام آتا ہے۔ ہر پنچ ایک بار بھیجیں: ایک ہی پنچ دو بار بھیجا جائے تو ٹائم شیٹ پر دو بار آتا ہے، اور منیجر ایک کو ہٹاتا ہے۔
• ویب ہکس خفیہ کوڈ سے دستخط شدہ ہوتے ہیں (X-Hr-Signature ہیڈر میں HMAC-SHA256)۔ ناکام ترسیل تقریباً ایک دن تک دہرائی جاتی ہے؛ جو ویب ہک لگاتار 20 بار ناکام ہو وہ بند ہو جاتا ہے جب تک آپ اسے پھر چالو نہ کریں۔
• ابھی کسی لائیو اینڈ پوائنٹ پر نہیں آزمایا گیا: ویب ہک کی ترسیل صرف ہمارے اپنے ٹیسٹ سیٹ اپ میں آزمائی گئی ہے۔ اس پر بھروسا کرنے سے پہلے اپنے سسٹم کے ساتھ آزما لیں۔
• کلیدیں بنانا اور منسوخ کرنا، اور بھیجا گیا ہر پنچ، سرگرمی کے ریکارڈ میں درج ہوتے ہیں۔
• ڈویلپرز کے لیے تکنیکی حوالہ صفحے سے لنک ہے: اسے کال کرنے کا طریقہ پڑھیں۔