Tüm Pozisyonları Getir

Tüm Pozisyonları Getir endpoint’i, bir organizasyondaki tüm pozisyonları, isimlerini ve temel detaylarını çekmek için tasarlanmıştır. Bu özellik, İK sistemleri ve üçüncü taraf entegrasyonların organizasyonel rolleri görüntülemesi veya işlemesi için özellikle yararlıdır.

---

Endpoint Genel Bakış

• HTTP Yöntemi: GET
• Endpoint URL:
  https://api.vinter.me/api/v1/Position/GetAllPositionWithName

---

İ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	İstek gövdesinin medya tipini belirtir.	application/json

---

Yanıt Formatı

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

{
  "data": [
    {
      "id": "beb1a5ca-8ff4-43a0-bd29-788dc6f58cf9",
      "title": "Yazılım Mimarı Pozisyonu",
      "isActive": false,
      "isCompleted": false,
      "createdAt": "2024-08-19T15:23:24.547911+03:00",
      "completedDate": null,
      "activatedDate": null
    },
    {
      "id": "38ff8726-bb96-42ed-b2d7-0ddbcda00af2",
      "title": "Yazılım Mühendisi Pozisyonu",
      "isActive": true,
      "isCompleted": false,
      "createdAt": "2024-02-13T18:16:37.933796+03:00",
      "completedDate": null,
      "activatedDate": "2024-02-13T18:16:37.931685+03:00"
    }
  ],
  "success": true,
  "message": null,
  "isResourceKey": true
}

---

Detaylı Alan Açıklamaları

• id:
  Pozisyona ait benzersiz kimlik.

• title:
  Pozisyonun adı veya unvanı. Bu genellikle organizasyondaki pozisyonun resmi adını ifade eder.

• isActive:
  Pozisyonun şu anda aktif olup olmadığını gösteren boolean değer. true ise pozisyon şu anda açık veya kullanılmaktadır.

• isCompleted:
  Pozisyonun tamamlanıp tamamlanmadığını gösteren boolean değer. Bu genellikle pozisyonun artık aktif olmadığını veya kapatıldığını belirtir.

• createdAt:
  Pozisyonun oluşturulma zamanını belirten zaman damgası.

• completedDate:
  Pozisyonun tamamlandığı tarihi gösteren zaman damgası. Null ise, pozisyon henüz tamamlanmamış demektir.

• activatedDate:
  Pozisyonun etkinleştirildiği tarihi gösteren zaman damgası. Null ise, pozisyon şu anda aktif olmayabilir.

---

Kullanım Alanları

• İK Panelleri: Tüm aktif ve pasif pozisyonların listesini alarak organizasyon içinde gözden geçirmek.
• Üçüncü Taraf Entegrasyonları: Dış sistemlerin raporlama, analiz veya otomasyon amaçlı pozisyon verilerini çekmesini sağlamak.
• Süreç Optimizasyonu: Pozisyonların güncel bir görünümünü sağlayarak İK ve işe alım ekiplerinin işe alım iş akışlarını düzenlemesi.

---

Hata Kodları

HTTP Kodu	Durum	Açıklama
400	Geçersiz İstek	İstek geçersiz veya eksik parametreler içeriyor.
401	Yetkilendirme Başarısız	API anahtarı eksik veya geçersiz olduğu için kimlik doğrulama başarısız oldu.
404	Bulunamadı	İstenen kaynak bulunamadı.
500	Dahili Hata	Dahili bir sunucu hatası meydana geldi.