REST API Referansi
Tum API uc noktalari /api/ on ekiyle baslar ve oturum cerezleri ile kimlik dogrulama gerektirir. Tum istekler ve yanitlar Content-Type: application/json kullanir.
Gorusmeler
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/conversations | GET | Gorusmeleri listele (filtreler: status, channel_type, tag, search, page) |
/api/conversations/{id} | GET | Gorusme getir (unread_count sifirlar) |
/api/conversations | POST | Gorusme olustur |
/api/conversations/{id}/status | POST | Durumu guncelle |
/api/conversations/{id}/tags | POST | Etiket ekle |
/api/conversations/{id}/tags/{tag} | DELETE | Etiket kaldir |
/api/conversations/{id}/assign | POST | Temsilci ata |
Mesajlar
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/conversations/{id}/messages | GET | Mesajlari listele |
/api/conversations/{id}/messages | POST | Mesaj gonder |
AI Onerisi
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/ai-suggest?conversation_id={id} | GET | AI yanit onerisi al |
Kisiler
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/contacts | GET | Kisileri listele |
/api/contacts/{id} | GET | Kisi getir |
/api/contacts | POST | Kisi olustur |
/api/contacts/{id} | PATCH | Kisi guncelle |
/api/contacts/{id} | DELETE | Kisi sil (yonetici) |
Kanallar (Yalnizca Yonetici)
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/channels | GET | Kanallari listele |
/api/channels | POST | Kanal olustur |
/api/channels/{id} | PATCH | Kanal guncelle |
/api/channels/{id} | DELETE | Kanal sil |
Otomasyonlar (Yalnizca Yonetici)
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/automations | GET | Otomasyonlari listele |
/api/automations | POST | Otomasyon olustur |
/api/automations/{id}/toggle | POST | Aktif/pasif degistir |
/api/automations/{id} | DELETE | Otomasyon sil |
Analitik
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/analytics?days=30 | GET | Analitik verilerini al |
Temsilciler (Yalnizca Yonetici)
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/agents | GET | Temsilcileri listele |
/api/agents | POST | Temsilci olustur |
/api/agents/{id}/role | POST | Rolu guncelle |
/api/agents/{id} | DELETE | Temsilci sil |
Ayarlar
| Uc Nokta | Yontem | Aciklama |
|---|---|---|
/api/settings/workspace | GET | Calisma alani ayarlarini al |
/api/settings/workspace | POST | Calisma alanini guncelle (yonetici) |
/api/settings/password | POST | Sifre degistir |
Hata Formati
{"error": "Human-readable error message"}
| Kod | Anlam |
|---|---|
200 | Basarili |
201 | Olusturuldu |
400 | Hatali Istek |
401 | Kimlik Dogrulanmadi |
403 | Yasakli |
404 | Bulunamadi |
409 | Catisma |
500 | Dahili Hata |