API Referansı

DOLU.ai REST API'si ile uygulamanızı entegre edin.

Genel Bakış

DOLU.ai API'si RESTful prensiplerine uygun olarak tasarlanmıştır. Tüm istekler HTTPS üzerinden yapılmalıdır.

Base URL

https://api.dolu.ai/api/v1

Kimlik Doğrulama

Tüm API istekleri JWT token ile kimlik doğrulaması gerektirir.

curl -X GET "https://api.dolu.ai/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Yanıt Formatı

Tüm yanıtlar JSON formatındadır:

{
  "success": true,
  "data": { ... },
  "message": "İşlem başarılı"
}

Hata Yanıtları

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Geçersiz e-posta adresi"
  }
}

HTTP Durum Kodları

Kod	Açıklama
200	Başarılı
201	Oluşturuldu
400	Geçersiz istek
401	Kimlik doğrulama gerekli
403	Erişim reddedildi
404	Bulunamadı
429	Çok fazla istek
500	Sunucu hatası

Rate Limiting

API istekleri dakikada 100 istek ile sınırlıdır. Limit aşıldığında 429 Too Many Requests yanıtı alırsınız.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000

Sayfalama

Liste endpoint'leri sayfalama destekler:

GET /api/v1/contacts?page=1&limit=20

Yanıt:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Mevcut Endpoint'ler

Kişiler (Contacts)

• GET /contacts - Kişi listesi
• POST /contacts - Yeni kişi oluştur
• GET /contacts/:id - Kişi detayı
• PUT /contacts/:id - Kişi güncelle
• DELETE /contacts/:id - Kişi sil

Konuşmalar (Conversations)

• GET /conversations - Konuşma listesi
• GET /conversations/:id - Konuşma detayı
• POST /conversations/:id/messages - Mesaj gönder

Fırsatlar (Deals)

• GET /deals - Fırsat listesi
• POST /deals - Yeni fırsat oluştur
• PUT /deals/:id - Fırsat güncelle
• DELETE /deals/:id - Fırsat sil

Görevler (Tasks)

• GET /tasks - Görev listesi
• POST /tasks - Yeni görev oluştur
• PUT /tasks/:id - Görev güncelle
• DELETE /tasks/:id - Görev sil

Detaylı Dokümantasyon

Detaylı API dokümantasyonu için Postman Collection sayfasından API anahtarınızı alabilirsiniz.