Kisiler API

Kisi kayitlarini programatik olarak yonetin.

Endpoints

Method	Endpoint	Aciklama
GET	/contacts	Kisi listesi
POST	/contacts	Yeni kisi
GET	/contacts/:id	Kisi detayi
PUT	/contacts/:id	Kisi guncelleme
DELETE	/contacts/:id	Kisi silme

Kisi Listesi

GET /api/v1/contacts

Query Parameters

Parametre	Tip	Aciklama
page	number	Sayfa numarasi (varsayilan: 1)
limit	number	Sayfa basi kayit (varsayilan: 20, max: 100)
search	string	Ad, email veya telefonda ara
tag	string	Etikete gore filtrele
createdAfter	date	Belirli tarihten sonra olusturulan
createdBefore	date	Belirli tarihten once olusturulan

Ornek Istek

curl -X GET "https://api.dolu.ai/api/v1/contacts?page=1&limit=20&search=ahmet" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ornek Yanit

{
  "success": true,
  "data": [
    {
      "id": "contact_abc123",
      "firstName": "Ahmet",
      "lastName": "Yilmaz",
      "email": "[email protected]",
      "phone": "+905551234567",
      "company": "ABC Ltd",
      "position": "Mudur",
      "tags": ["VIP", "Istanbul"],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-20T14:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Yeni Kisi Olusturma

POST /api/v1/contacts

Request Body

{
  "firstName": "Ahmet",
  "lastName": "Yilmaz",
  "email": "[email protected]",
  "phone": "+905551234567",
  "company": "ABC Ltd",
  "position": "Mudur",
  "address": {
    "street": "Ataturk Cad. No:123",
    "city": "Istanbul",
    "country": "Turkiye"
  },
  "tags": ["VIP"],
  "customFields": {
    "source": "web",
    "referral": "google"
  }
}

Zorunlu Alanlar

• firstName veya lastName
• email veya phone

Ornek Yanit

{
  "success": true,
  "data": {
    "id": "contact_xyz789",
    "firstName": "Ahmet",
    "lastName": "Yilmaz",
    "email": "[email protected]",
    "phone": "+905551234567",
    "createdAt": "2024-01-21T09:00:00Z"
  },
  "message": "Kisi basariyla olusturuldu"
}

Kisi Detayi

GET /api/v1/contacts/:id

Ornek Istek

curl -X GET "https://api.dolu.ai/api/v1/contacts/contact_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ornek Yanit

{
  "success": true,
  "data": {
    "id": "contact_abc123",
    "firstName": "Ahmet",
    "lastName": "Yilmaz",
    "email": "[email protected]",
    "phone": "+905551234567",
    "company": "ABC Ltd",
    "position": "Mudur",
    "address": {
      "street": "Ataturk Cad. No:123",
      "city": "Istanbul",
      "country": "Turkiye"
    },
    "tags": ["VIP", "Istanbul"],
    "customFields": {
      "source": "web"
    },
    "conversations": [
      {
        "id": "conv_123",
        "channel": "whatsapp",
        "status": "closed",
        "lastMessage": "2024-01-20T14:45:00Z"
      }
    ],
    "deals": [
      {
        "id": "deal_456",
        "name": "Proje X",
        "value": 50000,
        "stage": "proposal"
      }
    ],
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-20T14:45:00Z"
  }
}

Kisi Guncelleme

PUT /api/v1/contacts/:id

Request Body

Sadece guncellemek istediginiz alanlari gonderin:

{
  "company": "XYZ A.S.",
  "position": "Genel Mudur",
  "tags": ["VIP", "Enterprise"]
}

Kisi Silme

DELETE /api/v1/contacts/:id

Ornek Yanit

{
  "success": true,
  "message": "Kisi basariyla silindi"
}

Etiket Yonetimi

Etiket Ekleme

POST /api/v1/contacts/:id/tags

{
  "tags": ["Yeni Etiket", "Diger Etiket"]
}

Etiket Silme

DELETE /api/v1/contacts/:id/tags/:tagName

Notlar

Not Ekleme

POST /api/v1/contacts/:id/notes

{
  "content": "Musteri ile gorusme yapildi, teklif gonderilecek."
}

Hata Kodlari

Kod	Mesaj	Aciklama
400	Bad Request	Gecersiz veri formati
404	Not Found	Kisi bulunamadi
409	Conflict	Email veya telefon zaten kayitli
422	Unprocessable	Zorunlu alan eksik