Skip to main content

Pozisyon Bazında Adayları Listele

Bu endpoint, belirli bir pozisyon için davet edilmiş adaylara ait bilgileri ve mevcut durumlarını getirir.

HTTP İstek Detayları​

  • Yöntem: GET
  • URL:
    https://api.vinter.me/api/v1/Position/GetInvitedApplicantsByPosition?positionId={positionId}

İstek Başlıkları​

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

Yanıt Formatı​

Başarılı bir istek sonucunda dönen yanıt şu yapıda olacaktır:

{
  "data": [
    {
      "id": "754f1723-a8bc-4fa6-add1-6e91133e312c",
      "name": "Kaan",
      "surname": "KIVIRCIK",
      "email": "[email protected]",
      "status": "completed"
    },
    {
      "id": "899bfc09-1096-429c-9a4e-48eab7908316",
      "name": "Musa",
      "surname": "ERTEK",
      "email": "[email protected]",
      "status": "in_progress"
    },
    {
      "id": "754f1723-a8bc-4fa6-add1-6e91133e312c",
      "name": null,
      "surname": null,
      "email": "[email protected]",
      "status": "response_awaited"
    }
  ],
  "success": true,
  "message": null,
  "isResourceKey": true
}

Detaylı Alan Açıklamaları​

  • id:
    Adayın benzersiz kimliği.

  • name:
    Adayın adı. Sağlanmadıysa null olabilir.

  • surname:
    Adayın soyadı. Sağlanmadıysa null olabilir.

  • email:
    Adayın e-posta adresi. Birincil iletişim bilgisi olarak kullanılır.

  • status:
    Adayın başvuru sürecindeki mevcut durumu.

    • completed: Adayın başvuru süreci tamamlanmış.
    • in_progress: Adayın değerlendirme veya işe alım adımları devam ediyor.
    • response_awaited: Aday davet edilmiş ancak henüz yanıt vermemiş.

Kullanım Alanları​

  • Aday Takibi:
    İK ekipleri, belirli bir pozisyon için tüm adayların başvuru durumlarını takip edebilir.

  • İşe Alım Araçları ile Entegrasyon:
    Üçüncü taraf işe alım sistemleri, aday başvuru durumlarını gerçek zamanlı olarak görüntülemek için bu endpoint’i kullanabilir.

  • İletişim Sürekliliği:
    Her adayın durumunu bilerek, İK ekipleri zamanında hatırlatmalar gönderebilir, adayları bir sonraki aşamaya taşıyabilir veya tamamlanan başvuruları kapatabilir.