# Client API ile entegrasyon

> EQLEM CRM'e kendi uygulamanızdan API anahtarıyla bağlanın. Anahtar kapsamı, bağlı kullanıcı yetkisi, IP kısıtı, hız sınırı ve OpenAPI belge arayüzü.

Source: https://www.eqlem.com/tr/ozellikler/client-api-entegrasyonu

Kendi uygulamanızı, web sitenizi ya da iş akışı aracınızı EQLEM CRM'e **API anahtarıyla** bağlayın. Anahtarı EQLEM'in **Entegrasyon > Client API anahtarları** ekranından kendiniz oluşturursunuz; anahtarın yetkisi, bağladığınız kullanıcının EQLEM yetkisini aşamaz.
Genel bakış için [CRM modülü](https://www.eqlem.com/tr/moduller/crm) sayfasına bakın.

## Kimler için?

CRM verisini kendi sistemine okuyan ya da yazan yazılım ekipleri, formlardan gelen adayları CRM'e düşürmek isteyen web ajansları ve entegrasyon iş ortakları için. Anahtarı yöneten kişi, EQLEM'de **Client API anahtarları** yetkisi olan ve lisansında Uygulama Entegrasyonu açık bir kullanıcıdır.

## Nasıl çalışır?

### Anahtar oluşturma

**Entegrasyon > Client API anahtarları** ekranında anahtara bir ad verir, **bağlı kullanıcıyı** seçer ve kapsamı belirlersiniz:

- **Okuma** (`CrmRead`) ve **Yazma** (`CrmWrite`) kapsamları ayrı verilir.
- Admin olmayan kullanıcı anahtarı yalnız kendisine bağlayabilir ve yalnız kendi anahtarlarını görür; Admin tüm anahtarları yönetir.
- İsteğe bağlı olarak bitiş tarihi ve IP kısıtı (tek IP ya da CIDR) tanımlarsınız.
- Anahtarın tamamı oluşturulurken **yalnız bir kez** gösterilir; kaydettiğinizden emin olduktan sonra pencereyi kapatırsınız. Kaybederseniz anahtarı yeniler (rotate) ve yenisini alırsınız.

### Yetki: bağlı kullanıcı ve kapsam birlikte

Anahtarla yapılan her istek, bağlı kullanıcı adına çalışır. Anahtarın yapabildiği, **bağlı kullanıcının EQLEM yetkisi ile anahtarın kapsamının kesişimidir**. Kullanıcının göremediği kayıt API'den de görünmez; okuma kapsamı olan anahtar yazamaz.

### Hangi uçlar açık?

Public API, yalnızca işaretli **CRM uçlarını** açar: cari, kişi, grup, not, aktivite, fırsat, aşama, bölge, takvim, lead içe aktarma, kampanya, outreach, sequence, gelen kutusu, uyumluluk okuma, sözleşme, servis talebi ve analitik. İşaretli olmayan hiçbir uç anahtarla çalışmaz.

- **Silme, toplu silme, senkronizasyon ve webhook uçları public API'de yoktur.**
- Kişi ve cari yanıtlarında TCKN, doğum günü ve kan grubu **dönmez** (KVKK).
- Mesaj gönderen uçlar (mail, WhatsApp, yanıt, kampanya planlama) ayrı, daha düşük bir hız sınırına tabidir.

### Belge arayüzü

Kullanılabilir uçların listesi ve şemaları **OpenAPI** belgesi olarak yayınlanır. Firmanızın EQLEM API adresinde `/api/v2/public/docs` adresi etkileşimli belge arayüzünü, `/api/v2/public/openapi.json` ise makine tarafından okunabilir belgeyi verir.
Belgede yalnız public uçlar yer alır; kiracı verisi içermez. Aynı ekranda belge bağlantısı ve örnek istek de görünür.

### Güvenlik ve işletim

- **Başlıkla kimlik doğrulama:** anahtar `X-Api-Key` başlığında gönderilir; adres satırı (query string) ile gönderilen anahtar kabul edilmez.
- **Hız sınırı:** her anahtar için genel dakika sınırı ile mesaj gönderen uçlar için dakika ve saat sınırı ekrandan ayarlanır; aşımda `429` ve bekleme süresi döner.
- **Yenile, pasif yap, iptal et:** bu işlemler en geç birkaç saniye içinde etkili olur.
- **Denetim kaydı:** her anahtarlı istek 90 gün boyunca kaydedilir; kayıtta anahtar, uç, durum kodu ve IP bulunur, istek içeriği ve anahtar yazılmaz.
- **KVKK:** anahtarla çekilen kişisel verinin işlenmesinden sorumlu olan sizsiniz; anahtarı gizli tutun ve yalnız gereken kapsamı verin.

IP kısıtının bir proxy ya da yük dengeleyici arkasında doğru çalışması için platform yöneticisinin dağıtım ayarı gerekir; bu, anahtar ekranından yapılan bir ayar değildir.

## Faydalar

Entegrasyon için kullanıcı parolası paylaşılmaz; anahtar her an yenilenir ya da iptal edilir. Yetki yeni bir model olarak eklenmez, mevcut CRM yetkileri kullanılır. Hız sınırı, IP kısıtı ve denetim kaydı yanlış kullanımı sınırlar ve izlenebilir kılar.

## Modüller ve ürünlerle ilişki

Client API, [CRM modülünün](https://www.eqlem.com/tr/moduller/crm) ve [kişi gruplarının](https://www.eqlem.com/tr/ozellikler/kisi-gruplari) verilerine açılır. AI ajanıyla bağlanmak isterseniz [AI ajan bağlantısı](https://www.eqlem.com/tr/ozellikler/ai-ajan-baglantisi) sayfasına bakın.
Teknik ayrıntılar ayrı bir Client API Geliştirici Rehberi'nde anlatılır. Özellik web ekranı ve API olarak sunulur; mobil uygulamada anahtar yönetimi yoktur.

## Sık sorulanlar

**Anahtarı kaybettim, tekrar görebilir miyim?** Hayır; anahtar yalnız oluşturma ve yenileme anında gösterilir. Yenileyip yeni anahtarı alın.

**Anahtar ne kadar sürede iptal olur?** Yenileme, pasif yapma ve iptal en geç birkaç saniye içinde etkili olur.

**API ile kayıt silebilir miyim?** Hayır; silme public API'de yoktur.

**Hangi lisans ve yetki gerekir?** Lisansta Uygulama Entegrasyonu ve EQLEM'de Client API anahtarları yetkisi.

## Sonraki adım

[CRM modülünü](https://www.eqlem.com/tr/moduller/crm) inceleyin, **Teknik görüşme isteyin** ya da **Ücretsiz Dene** ile başlayın.