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=371473fc-656d-41ef-8887-3a4c5d544eca

---

İ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": "1bc078a6-8c2c-415f-bea5-86312d6108f2",
            "fullName": "Murat ŞAHİN",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "9fcfdae7-3b05-4753-a944-a7398131454d",
            "fullName": "Musa ERTEK",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Teknik Değerlendirme Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "1ef4655f-6f77-4d6c-b6e3-73d4fb175d2d",
            "fullName": "Şükran ÖZBEK",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "ac512aeb-6c27-414b-8cda-6497500952bd",
            "fullName": "Yağız TÜRER",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Bilişsel Yetenek Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "4aa949f3-b1e5-44c8-a274-aa4ca7d90438",
            "fullName": "Alper ÖZER",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "07fa2316-82a2-4ede-8656-90766ffc7957",
            "fullName": "Ecem Yazgı BEKİM",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Yabancı Dil Yeterlilik Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "5839b683-1dc9-4672-aab6-044d4c7bd740",
            "fullName": "Batuhan SEYMAN",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "320df362-4717-40eb-92b9-4e471dc7b95d",
            "fullName": "Aydın BAŞAK",
            "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", "inactive", "completed").

• 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.

---