Tüm Pozisyon Adımları ve Adayları Getirme

Bu endpoint, belirli bir pozisyonun tüm adımları ve her adıma atanan tüm adaylar dahil olmak üzere kapsamlı bilgilerini döndürür.

---

Endpoint Genel Bakış

• HTTP Method: GET
• Endpoint URL:
  https://api.vinter.me/api/v1/Position/GetStepsAndAllApplicants?positionId={positionId}

---

İstek Başlıkları

Başlık Adı	Açıklama	Örnek Değer
X-Api-Key	Organizasyonel kimlik doğrulama için API anahtarı.	api_key
Content-Type	İsteğin medya türünü belirtir.	application/json

---

Yanıt Formatı

Başarılı bir istek aşağıdaki yapıda bir JSON nesnesi döndürür:

{
  "data": {
    "positionId": "371473fc-656d-41ef-8887-3a4c5d544eca",
    "title": "Senior Software Architect",
    "status": "active",
    "responsibleName": "Kaan KIVIRCIK",
    "language": "tr-TR",
    "location": "İzmir, Turkey",
    "createdAt": "2025-05-07T12:05:48.508927+00:00",
    "completedDate": null,
    "activatedDate": "2025-05-07T12:05:48.504923+00:00",
    "positionSteps": [
      {
        "stepName": "Yetkinlik Envanteri Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
           {
             "applicationStepId": "c29dc968-f337-4676-8e0b-407b66c2207c",
             "fullName": "Batuhan SEYMAN",
             "email": "[email protected]",
             "stepVinterScore": 72.16,
             "stepStatus": "completed"
          },
          {
             "applicationStepId": "72e6da4d-bda5-47fa-ab9f-8617f6b29136",
             "fullName": "Musa Ertek",
             "email": "[email protected]",
             "stepVinterScore": 86.21,
             "stepStatus": "completed"
          },
        ]
      },
      {
        "stepName": "Backend - Teknik Değerlendirme Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
           {
             "applicationStepId": "b74732ac-f1ef-4a22-8227-d842f0c582b1",
             "fullName": "Batuhan SEYMAN",
             "email": "[email protected]",
             "stepVinterScore": 67.79,
             "stepStatus": "completed"
          },
          {
             "applicationStepId": "2a4f2f85-cc3b-418e-a2bd-e01812b034ce",
             "fullName": "Musa Ertek",
             "email": "[email protected]",
             "stepVinterScore": 69.45,
             "stepStatus": "completed"
          },
        ]
      },
      {
        "stepName": "Frontend - Teknik Değerlendirme Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
           {
             "applicationStepId": "b506a16b-da8f-4e41-9547-e68b46ba99ba",
             "fullName": "Batuhan SEYMAN",
	           "email": "[email protected]",
             "stepVinterScore": 60.17,
             "stepStatus": "completed"
          },
          {
             "applicationStepId": "3b67cb88-84bc-4f12-ab81-cac67949639b",
             "fullName": "Musa Ertek",
             "email": "[email protected]",
             "stepVinterScore": 56.48,
             "stepStatus": "completed"
          },
        ]
      },
      {
        "stepName": "Bilişsel Yetenek Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
           {
              "applicationStepId": "9c17a9ff-6600-43e9-9875-f907ee08608c",
              "fullName": "Batuhan SEYMAN",
	      "email": "[email protected]",
              "stepVinterScore": 78.57,
              "stepStatus": "completed"
          },
          {
             "applicationStepId": "070fca9c-73f8-4e4d-b220-9bced16d4e06",
             "fullName": "Musa Ertek",
             "email": "[email protected]",
             "stepVinterScore": 78.57,
             "stepStatus": "completed"
          },
        ]
      },
      {
        "stepName": "Yabancı Dil Yeterlilik Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
           {
             "applicationStepId": "7893e887-07e0-4a43-be02-f5b5509e2c2d",
             "fullName": "Batuhan SEYMAN",
	           "email": "[email protected]",
             "stepVinterScore": 65.00,
             "stepStatus": "completed"
            },
            {
             "applicationStepId": "3f5f2613-ef75-42f4-867e-d9a804beadfa",
             "fullName": "Musa Ertek",
             "email": "[email protected]",
             "stepVinterScore": null,
             "stepStatus": "expected"
            },
          ]
        },
      ]
    },
  "success": true,
  "message": null,
  "isResourceKey": true
}

---

Detaylı Alan Açıklamaları

• positionId:
  Getirilen pozisyonun benzersiz tanımlayıcısı.

• title:
  Pozisyonun adı.

• status:
  Pozisyonun mevcut durumu (örn. "active", "passive", "closed").

• responsibleName:
  Pozisyondan sorumlu kişinin adı.

• language:
  Pozisyonla ilişkili birincil dil (örn. "tr-TR", "en-US").

• location:
  Pozisyonun coğrafi konumu.

• createdAt:
  Pozisyonun oluşturulduğu zaman damgası.

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

• activatedDate:
  Pozisyonun aktif hale geldiği zaman damgası.

• positionSteps:
  Pozisyonla ilişkili tüm adımların kapsamlı listesi, aşağıdakileri içerir:

  • stepName: Adımın adı
  • isStaticStep: Adımın önceden tanımlanmış statik bir adım olup olmadığı
  • staticStepId: Statik adımın ID'si (varsa)
  • applicants: Bu adıma atanan tüm adaylar, aşağıdaki detaylarla:
    • applicationStepId: Başvuru adımı için benzersiz tanımlayıcı
    • fullName: Adayın tam adı
    • email: Adayın e-posta adresi
    • stepVinterScore: Bu adım için Vinter skoru (varsa)
    • stepStatus: Adayın bu adımdaki mevcut durumu

---

Kullanım Alanları

• Kapsamlı Genel Bakış:
  Bu endpoint, tüm pozisyon adımları ve tüm adayların eksiksiz bir görünümünü sağlar, bu da kapsamlı raporlama ve analiz için idealdir.

• İlerleme Takibi:
  İK ve işe alım ekipleri, tek bir istekle tüm adayların farklı adımlardaki ilerlemesini takip edebilir.

• Veri Entegrasyonu:
  Üçüncü taraf sistemler, pozisyon performansı ve aday dağılımı hakkında detaylı analizler sağlamak için bu kapsamlı veriyi kullanabilir.

• Yönetimsel Kontrol:
  Yöneticiler, işe alım sürecinin tam bir genel bakışını elde ederek darboğazları tespit edebilir ve işe alım sürecini optimize edebilir.

---