Skip to main content

Pozisyon Detayını Getir

Bu endpoint, belirli bir pozisyona ait detaylı bilgileri, adımları ve ilgili adayları getirmek için kullanılır.

Endpoint Genel Bakış​

  • HTTP Yöntemi: GET
  • Endpoint URL:
    https://api.vinter.me/api/v1/Position/GetStepsAndApplicants?positionId=2ec6acd7-b976-4a58-aff4-e32c4121d73f

İstek Başlıkları​

Başlık AdıAçıklamaÖrnek Değer
X-Api-KeyOrganizasyon kimlik doğrulama 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 JSON yapısı şu şekildedir:

{
  "data": {
    "positionId": "2ec6acd7-b976-4a58-aff4-e32c4121d73f",
    "title": "Yazılım Mimarı Pozisyonu",
    "isActive": true,
    "isCompleted": false,
    "responsibleName": "Murat SAHIN",
    "language": "tr-TR",
    "location": "Bornova, İzmir, Turkey",
    "createdAt": "2025-02-11T17:28:00.164484+03:00",
    "completedDate": null,
    "activatedDate": "2025-02-12T14:38:39.452059+03:00",
    "positionSteps": [
      {
        "stepName": "Teknik Değerlendirme Adımı",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "fullName": "Kaan KIVIRCIK",
            "email": "[email protected]",
            "isGeneralApplicationFormFilled": null,
            "stepVinterScore": null,
            "isStepCompleted": false
          }
        ]
      },
      {
        "stepName": "Kısa Liste",
        "isStaticStep": true,
        "staticStepId": "3",
        "applicants": []
      }
    ]
  },
  "success": true,
  "message": null,
  "isResourceKey": true
}

Detaylı Alan Açıklamaları​

  • positionId:
    Alınan pozisyona ait benzersiz kimlik.

  • title:
    Pozisyonun adı.

  • isActive:
    Pozisyonun şu anda aktif olup olmadığını belirtir.

  • isCompleted:
    Pozisyonun tamamlanıp tamamlanmadığını belirtir.

  • responsibleName:
    Pozisyondan sorumlu kişinin adı.

  • language:
    Pozisyonla ilişkilendirilen birincil dil.

  • location:
    Pozisyonun coğrafi konumu.

  • createdAt:
    Pozisyonun oluşturulduğu zaman.

  • completedDate:
    Pozisyonun tamamlandığı zaman (eğer varsa).

  • activatedDate:
    Pozisyonun aktif hale geldiği zaman.

  • positionSteps:
    Pozisyonla ilişkili adımların bir listesi. Bu liste, adımların adlarını, statik veya dinamik olup olmadıklarını ve her adımla ilişkilendirilen adayları içerir.

Kullanım Alanları​

  • İlerleme Takibi:
    İK ve işe alım ekipleri, bir pozisyonun farklı aşamalarda hangi durumda olduğunu izleyebilir.

  • Veri Entegrasyonu:
    Üçüncü taraf sistemler, pozisyon durumu ve aday havuzu ile ilgili ayrıntılı raporlama ve analiz yapmak için bu verileri kullanabilir.

  • Daha İyi Karar Alma:
    Aktif ve tamamlanmış adımların net bir şekilde görüntülenmesi, yöneticilerin darboğazları belirlemelerine ve işe alım sürecini optimize etmelerine olanak tanır.