API Anahtarları
API Anahtarları, LeadHub REST API'sine programatik erişim sağlayan Bearer token'larıdır. Bunları özel entegrasyonlar oluşturmak, diğer sistemlerle veri senkronize etmek veya kod aracılığıyla görevleri otomatikleştirmek için kullanın.
API Anahtarı Oluşturma
- Entegrasyonlar → API Anahtarları'na gidin.
- Yeni API Anahtarı'na tıklayın.
- Doldurun:
| Alan | Açıklama |
|---|---|
| Ad | Açıklayıcı bir ad (örn. "Uygulama Entegrasyonum", "Zapier") |
| İzinler | Bu anahtarın hangi işlemleri gerçekleştirebileceği (salt okunur, okuma-yazma) |
| Son Kullanma Tarihi | İsteğe bağlı son kullanma tarihi; son kullanma tarihi olmadan boş bırakın |
- Kaydet'e tıklayın.
- Token'ı hemen kopyalayın — yalnızca bir kez gösterilir. Kaybederseniz yeniden oluşturmanız gerekir.
API Anahtarı Kullanımı
Her API isteğinde anahtarı Bearer token olarak ekleyin:
GET /api/leads HTTP/1.1
Host: yourdomain.com
Authorization: Bearer YOUR_API_KEY_HERE
Content-Type: application/json
API Uç Noktaları
| Metot | Uç Nokta | Açıklama |
|---|---|---|
GET | /api/leads | Tüm müşteri adaylarını listele (sayfalandırılmış) |
GET | /api/leads/{id} | Tek bir müşteri adayı al |
POST | /api/leads | Yeni müşteri adayı oluştur |
PUT | /api/leads/{id} | Müşteri adayını güncelle |
DELETE | /api/leads/{id} | Müşteri adayını sil |
GET | /api/pipelines | Hunileri listele |
GET | /api/tags | Etiketleri listele |
POST | /api/leads/{id}/tags | Müşteri adayına etiket ekle |
Tam API referansı kurulumunuzdaki /api/documentation adresindeki LeadHub Swagger belgelerinde mevcuttur.
Anahtarı İptal Etme
Bir API anahtarını iptal etmek için:
- Entegrasyonlar → API Anahtarları'na gidin.
- Anahtar satırındaki sil simgesine tıklayın ve onaylayın.
Anahtar hemen geçersiz hale gelir. Kullanan tüm istekler 401 Yetkisiz yanıtı alır.
Güvenlik En İyi Uygulamaları
- API anahtarlarını hiçbir zaman sürüm kontrolüne (GitHub, Bitbucket vb.) kaydetmeyin
- Yalnızca veri okumaya ihtiyacınız varsa salt okunur anahtarlar kullanın
- Geçici entegrasyonlar için kullanılan anahtarlara son kullanma tarihleri belirleyin
- İfşa olmuş olabilecek anahtarları derhal iptal edin
- Her entegrasyon için ayrı bir anahtar kullanın, böylece belirli olanları bağımsız olarak iptal edebilirsiniz