Gorevler API

Gorevleri programatik olarak yonetin.

Endpoints

Method	Endpoint	Aciklama
GET	/tasks	Gorev listesi
POST	/tasks	Yeni gorev
GET	/tasks/:id	Gorev detayi
PUT	/tasks/:id	Gorev guncelleme
DELETE	/tasks/:id	Gorev silme

Gorev Listesi

GET /api/v1/tasks

Query Parameters

Parametre	Tip	Aciklama
page	number	Sayfa numarasi
limit	number	Sayfa basi kayit
status	string	pending, in_progress, completed
assignedTo	string	Atanan kisi
priority	string	low, medium, high, urgent
dueDate	date	Son tarih filtresi
contactId	string	Ilgili kisi
dealId	string	Ilgili firsat

Ornek Yanit

{
  "success": true,
  "data": [
    {
      "id": "task_abc123",
      "title": "Musteri arama",
      "description": "Teklif takibi icin arama yap",
      "type": "call",
      "status": "pending",
      "priority": "high",
      "dueDate": "2024-01-22T10:00:00Z",
      "assignedTo": {
        "id": "user_123",
        "name": "Ahmet Yilmaz"
      },
      "contact": {
        "id": "contact_xyz",
        "name": "ABC Sirket"
      },
      "deal": {
        "id": "deal_456",
        "name": "Kurumsal Paket"
      },
      "createdAt": "2024-01-20T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 25
  }
}

Yeni Gorev

POST /api/v1/tasks

Request Body

{
  "title": "Toplanti hazirligi",
  "description": "Sunum dosyasini hazirla",
  "type": "task",
  "status": "pending",
  "priority": "medium",
  "dueDate": "2024-01-25T14:00:00Z",
  "assignedTo": "user_123",
  "contactId": "contact_xyz",
  "dealId": "deal_456",
  "reminder": {
    "enabled": true,
    "before": 60
  }
}

Gorev Turleri

Tur	Aciklama
task	Genel gorev
call	Arama
meeting	Toplanti
email	E-posta
followup	Takip

Oncelik Seviyeleri

Oncelik	Aciklama
low	Dusuk
medium	Orta
high	Yuksek
urgent	Acil

Gorev Detayi

GET /api/v1/tasks/:id

Ornek Yanit

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "title": "Musteri arama",
    "description": "Teklif takibi icin arama yap",
    "type": "call",
    "status": "pending",
    "priority": "high",
    "dueDate": "2024-01-22T10:00:00Z",
    "assignedTo": {
      "id": "user_123",
      "name": "Ahmet Yilmaz",
      "email": "[email protected]"
    },
    "contact": {
      "id": "contact_xyz",
      "firstName": "Ali",
      "lastName": "Veli",
      "phone": "+905551234567"
    },
    "deal": {
      "id": "deal_456",
      "name": "Kurumsal Paket",
      "value": 50000
    },
    "reminder": {
      "enabled": true,
      "before": 60,
      "sentAt": null
    },
    "notes": [
      {
        "content": "Musteri saat 10'da musait",
        "createdBy": "user_789",
        "createdAt": "2024-01-21T09:00:00Z"
      }
    ],
    "createdAt": "2024-01-20T09:00:00Z",
    "updatedAt": "2024-01-21T09:00:00Z"
  }
}

Durum Guncelleme

PATCH /api/v1/tasks/:id/status

{
  "status": "completed",
  "note": "Gorusme yapildi, olumlu"
}

Mevcut Durumlar

Durum	Aciklama
pending	Bekliyor
in_progress	Devam ediyor
completed	Tamamlandi
cancelled	Iptal edildi

Atama

PATCH /api/v1/tasks/:id/assign

{
  "assignedTo": "user_456"
}

Not Ekleme

POST /api/v1/tasks/:id/notes

{
  "content": "Musteri yarini tercih etti"
}

Tekrarlayan Gorev

POST /api/v1/tasks

{
  "title": "Haftalik rapor",
  "type": "task",
  "dueDate": "2024-01-22T09:00:00Z",
  "assignedTo": "user_123",
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "daysOfWeek": ["monday"],
    "endDate": "2024-12-31"
  }
}

Tekrarlama Frekanslari

Frekans	Aciklama
daily	Gunluk
weekly	Haftalik
monthly	Aylik
yearly	Yillik

Bugunku Gorevler

GET /api/v1/tasks/today

Geciken Gorevler

GET /api/v1/tasks/overdue

Webhooks

Gorev olaylari:

• task.created - Gorev olusturuldu
• task.updated - Gorev guncellendi
• task.completed - Gorev tamamlandi
• task.overdue - Gorev gecikti
• task.reminder - Hatirlatma zamani

Webhook Payload

{
  "event": "task.completed",
  "timestamp": "2024-01-22T10:15:00Z",
  "data": {
    "taskId": "task_abc123",
    "completedBy": "user_123",
    "completedAt": "2024-01-22T10:15:00Z"
  }
}