Aday Detay Sayfası

Bu endpoint, adayın detay sayfasına kriptografik olarak korunmuş, doğrulama gerektirmeyen bir bağlantı oluşturmanıza olanak tanır. Bu bağlantı, diğer uygulamalar veya web siteleri içerisine gömülebilir; böylece ek kimlik doğrulama adımlarına gerek kalmaz.

HTTP İstek Detayları

• Yöntem: POST
• URL: https://api.vinter.me/api/v1/Application/CreateApplicationResultLink

İstek Başlıkları

Başlık Adı	Açıklama	Örnek Değer
X-Api-Key	Kurumsal kimlik doğrulama için kullanılan API anahtarı.	api_key
Content-Type	İstek gövdesinin medya tipini belirtir.	application/json

İstek Gövdesi Parametreleri

Parametre Adı	Tür	Gerekli	Açıklama	Örnek Değer
invitationId	String	Evet	Aday ile ilişkili davetiyenin ID’si.	cb9eaf83-bf12-4136-b2b5-635a016594d2

Örnek İstek Gövdesi

{
  "invitationId": "cb9eaf83-bf12-4136-b2b5-635a016594d2"
}

Yanıt Formatı

Başarılı bir istek sonucunda, aşağıdaki JSON yapısı döner:

{
  "data": null,
  "success": true,
  "message": "https://app.vinter.me/applicant-crypted/detail?crypted=dAsPTl%2fQ2xNvcOop5r8zH38GCcG4c%2fN1iyv%2fxl1gPT%2fmUeATL2iPD0BLhmulXpJID4bmxixIlGPWVZkKhlvCKWGgywZ6sbD%2bqnc6q2aZBcUNZPl7",
  "isResourceKey": true
}

Hata Kodları

HTTP Kodu	Durum	Açıklama
400	Bad Request	İstek, geçersiz veya eksik parametreler içeriyor.
401	Unauthorized	API anahtarı eksik veya geçersiz olduğunda oluşur.
404	Not Found	İstenen kaynak bulunamadı.
500	Internal Error	Dahili bir sunucu hatası oluştu.

Detaylı Açıklama

Bu endpoint, entegre bir işe alım platformunun önemli bir parçasıdır. Sağlanan kriptografik olarak korunan bağlantı, aday detaylarına yetkili kullanıcılar tarafından kolaylıkla erişim sağlar. Ek doğrulama adımlarını ortadan kaldırır ve üçüncü taraf sistemlere entegrasyon için basit ve güvenli bir yöntem sunar.

Öne Çıkan Özellikler:

1. Kriptografik Güvenlik: Oluşturulan bağlantı, verilerin değiştirilemez ve gizli kalmasını sağlamak için şifrelenmiştir.
2. Doğrulama Gerektirmeyen Erişim: Bağlantı oluşturulduktan sonra istemci tarafında ek kimlik doğrulama gerekmez, bu da süreci kolaylaştırır.
3. Kolay Entegrasyon: Diğer uygulamalarla sorunsuz bir şekilde çalışacak şekilde tasarlanmıştır ve geliştiriciler ile İnsan Kaynakları profesyonelleri için entegrasyon sürecini basitleştirir.

Kullanım Alanları:

• İşe Alım Panelleri: İK ekipleri, güvenli aday bağlantılarını iç panellerine hızlıca yerleştirebilir.
• Üçüncü Taraf Entegrasyonlar: Harici sistemler, aday detaylarını doğrudan gösterebilir ve karmaşık kimlik doğrulama mekanizmaları oluşturmalarına gerek kalmaz.
• Daha Akıcı Süreçler: Tekrarlanan kimlik doğrulama ve manuel veri paylaşımı ihtiyacını ortadan kaldırarak işe alım süreçlerinin verimliliğini artırır.

En İyi Uygulamalar:

• API Anahtarını Koruyun: X-Api-Key değerinin güvenli bir şekilde saklandığından ve asla açıkça paylaşılmadığından emin olun.
• Hataları Yönetin: Eksik veya geçersiz parametreler gibi olası sorunları ele almak için hata yönetimi mantığı uygulayın.
• Kullanımı İzleyin: Performans darboğazlarını belirlemek ve çözmek için istek sayısını ve yanıt sürelerini izleyin.

Bu yönergeleri izleyerek ve endpoint’in yeteneklerinden yararlanarak, organizasyonlar aday detaylarına erişim sürecini daha güvenli, verimli ve kullanıcı dostu bir hale getirebilir.