Geliştiriciler için API.
Kampanyalarınızı otomatikleştirin, Zapier/Make entegrasyonları kurun veya kendi uygulamalarınızı geliştirin.
1. API Anahtarı Alma
API'yi kullanmak için önce bir API anahtarı oluşturmanız gerekiyor:
Ayarlar sayfasına gidin
Hesabınıza giriş yapın ve Ayarlar sayfasını açın.
"API Anahtarları" bölümünü bulun
"Yeni API Anahtarı Oluştur" butonuna tıklayın.
Anahtar ayarlarını yapın
Anahtara bir isim verin (örn: "Zapier Entegrasyonu") ve gerekli izinleri seçin.
Önemli: Anahtarı kaydedin!
API anahtarı sadece oluşturulduğunda bir kez gösterilir. Güvenli bir yerde saklayın!
2. Kimlik Doğrulama
Tüm API isteklerinde Authorization header'ı
ile API anahtarınızı gönderin:
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Örnek cURL İsteği:
curl -X GET "https://app.siteniz.com/api/campaigns" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"Güvenlik: API anahtarınızı asla public repository'lerde, frontend kodunda veya güvensiz yerlerde paylaşmayın. Sızdırıldığını düşünüyorsanız hemen Ayarlar'dan iptal edin.
3. İzinler (Scopes)
API anahtarı oluştururken hangi işlemlere izin vereceğinizi seçebilirsiniz:
campaigns:read
Kampanyaları görüntüleme
campaigns:write
Kampanya oluşturma/düzenleme
businesses:read
İşletmeleri görüntüleme
businesses:write
İşletmeleri düzenleme
templates:read
E-posta şablonlarını görüntüleme
analytics:read
Analitik verilerini görüntüleme
4. API Endpoint'leri
Base URL: https://app.siteniz.com/api
/api/campaigns
campaigns:readTüm kampanyalarınızı listeleyin
Query Parameters:
limit- Sonuç sayısı (default: 10, max: 100)offset- Başlangıç noktası (default: 0)status- Durum filtresi (draft, running, completed, failed)
Response:
{
"success": true,
"campaigns": [
{
"id": 123,
"name": "İstanbul Restoranları",
"status": "completed",
"businesses_found": 50,
"emails_sent": 45,
"created_at": "2025-12-01T10:30:00Z"
}
],
"total": 15,
"limit": 10,
"offset": 0
}/api/campaigns/{'{id}'}
campaigns:readTek bir kampanyanın detaylarını getirin
Response:
{
"success": true,
"campaign": {
"id": 123,
"name": "İstanbul Restoranları",
"category": "Restoran",
"location": "İstanbul",
"status": "completed",
"businesses_found": 50,
"emails_sent": 45,
"emails_opened": 18,
"emails_clicked": 5,
"created_at": "2025-12-01T10:30:00Z",
"completed_at": "2025-12-01T11:45:00Z"
}
}/api/campaigns
campaigns:writeYeni bir kampanya oluşturun
Request Body:
{
"name": "Ankara Kafeler Kampanyası",
"category": "Kafe",
"location": "Ankara",
"max_businesses": 50,
"email_subject": "İşletmeniz İçin Özel Teklif",
"auto_start": false
}Response:
{
"success": true,
"message": "Kampanya oluşturuldu",
"campaign_id": 124
}/api/campaigns/{'{id}'}/businesses
businesses:readKampanyadaki işletmeleri listeleyin
Response:
{
"success": true,
"businesses": [
{
"id": 456,
"name": "Lezzet Cafe",
"email": "info@lezzetcafe.com",
"phone": "+90 312 xxx xxxx",
"address": "Kızılay, Ankara",
"email_status": "sent",
"email_opened": true
}
],
"total": 50
}/api/campaigns/{'{id}'}
campaigns:writeKampanyayı silin
Response:
{
"success": true,
"message": "Kampanya silindi"
}5. İstek Limitleri (Rate Limits)
API anahtarı oluştururken özel limitler belirleyebilirsiniz. Varsayılan limitler:
Aşılırsa 429 hatası alırsınız
Gece yarısı (UTC) sıfırlanır
İpucu: Rate limit header'larını kontrol edin:
X-RateLimit-Remaining ve
X-RateLimit-Reset
6. Hata Kodları
400
401
403
404
429
500
Hata Response Örneği:
{
"success": false,
"error": "Bu işlem için yetkiniz yok: campaigns:write",
"code": "insufficient_scope"
}7. Zapier / Make Entegrasyonu
StartupAI API'sini Zapier veya Make (Integromat) ile kullanarak iş akışlarınızı otomatikleştirin.
Zapier
- Zapier'da "Webhooks by Zapier" seçin
- Custom Request oluşturun
- URL: API endpoint'inizi girin
- Headers: Authorization ekleyin
Make (Integromat)
- HTTP modülünü ekleyin
- "Make a request" seçin
- URL ve Method ayarlayın
- Headers'a API key ekleyin
Yardıma ihtiyacınız mı var?
API kullanımı hakkında sorularınız için ekibimize yazın — 2 saat içinde dönüş.