Project Servisi API Dökümantasyonu (v3)

Proje yönetimi (ihale takibi) bu servis üzerinden yapılır. Bir proje; bir müşteriye bağlı, belirli tarihleri ve ihale bilgileri olan bir çalışma birimidir. Projelere araçlar atanabilir.

Base URL: /v3/projects

---

Enum Referansları

Project Status (status)

Değer	Açıklama
active	Aktif proje
passive	Pasif proje
completed	Tamamlanmış proje

---

1. Create Project (Proje Oluştur)

• URL: POST /
• Auth: ClientSecret + User
• Request Body:

  {
    "customer_id": "uuid (opsiyonel — müşteri ID)",
    "title": "Proje başlığı",
    "start_date": "2024-03-01",
    "end_date": "2024-12-31",
    "number_vehicles": 5,
    "number_workers": 10,
    "bid_price": 150000.00,
    "bid_register_number": "İhale kayıt no",
    "organisation_name": "Kurum adı",
    "organisation_tax_no": "Vergi no",
    "organisation_tax_office": "Vergi dairesi",
    "organisation_address": "Kurum adresi",
    "city_id": 34,
    "district_id": 100
  }

---

2. List Projects (Projeleri Listele)

• URL: GET /
• Auth: ClientSecret + User
• Query Params:
  • page[index], page[size]
  • search, include
  • filter[customer_id], filter[status], filter[start_date], filter[end_date]
  • sort[id], sort[type]

---

3. Project Details (Proje Detayı)

• URL: GET /:project_id
• Auth: ClientSecret + User

---

4. Update Project (Proje Güncelle)

• URL: PUT /:project_id
• Auth: ClientSecret + User
• Request Body: (tüm alanlar opsiyonel — Create ile aynı alanlar)

---

5. Delete Project (Proje Sil)

• URL: DELETE /:project_id
• Auth: ClientSecret + User

---

---

Project Vehicles (Proje Araçları)

Projeye araç atama ve yönetimi.

Base URL: /v3/projects/:project_id/vehicles

---

6. Create Project Vehicle (Projeye Araç Ata)

• URL: POST /
• Auth: ClientSecret + User
• Request Body:

  {
    "vehicle_id": "uuid (zorunlu — araç ID)"
  }

---

7. List Project Vehicles (Proje Araçlarını Listele)

• URL: GET /
• Auth: ClientSecret + User
• Query Params:
  • page[index], page[size]
  • search, include
  • sort[id], sort[type]

---

8. Project Vehicle Details (Proje Aracı Detayı)

• URL: GET /:vehicle_id
• Auth: ClientSecret + User

---

9. Update Project Vehicle (Proje Aracı Güncelle)

• URL: PUT /:vehicle_id
• Auth: ClientSecret + User
• Request Body: (tüm alanlar opsiyonel — Proje alanları ile aynı)

  {
    "customer_id": "uuid",
    "title": "Güncel proje başlığı",
    "start_date": "2024-03-01",
    "end_date": "2024-12-31",
    "number_vehicles": 10,
    "number_workers": 20,
    "bid_price": 200000.00,
    "bid_register_number": "İhale kayıt no",
    "organisation_name": "Kurum adı",
    "organisation_tax_no": "Vergi no",
    "organisation_tax_office": "Vergi dairesi",
    "organisation_address": "Kurum adresi",
    "city_id": 34,
    "district_id": 100
  }

---

10. Delete Project Vehicle (Proje Aracını Çıkar)

• URL: DELETE /:vehicle_id
• Auth: ClientSecret + User