REST API v2 Genel Bakış

FeedbackPulse SaaS, kiracı verilerinize programlı erişim için RESTful API (v2) sunar. Geri bildirimi kendi uygulamalarınıza entegre etmek, kontrol panelleri oluşturmak veya iş akışlarını otomatikleştirmek için kullanın.

---

Temel URL

https://yourdomain.com/api/v2

---

Kimlik Doğrulama

Tüm API istekleri bir Bearer token (API anahtarı) gerektirir:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://yourdomain.com/api/v2/submissions

API Anahtarı Alma

1. Kiracı kontrol panelinize giriş yapın
2. Ayarlar > API Anahtarları bölümüne gidin
3. API Anahtarı Oluştur seçeneğine tıklayın
4. Anahtarı hemen kopyalayın (yalnızca bir kez gösterilir!)

API anahtarları SHA256 hash'i olarak saklanır. Ham anahtar kurtarılamaz.

Plan gereksinimi: API erişimi, planınızda api_access özellik bayrağını gerektirir.

---

Hız Sınırlandırma

Sınır	Değer
Kiracı başına dakikada istek sayısı	60

Hız sınırı başlıkları her yanıtta yer alır:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57

---

Mevcut Uç Noktalar

Yöntem	Uç Nokta	Açıklama
GET	/api/v2/submissions	Gönderim listesi
GET	/api/v2/submissions/{id}	Tek gönderim getir
POST	/api/v2/submissions	Gönderim oluştur
GET	/api/v2/products	Ürün listesi
POST	/api/v2/products	Ürün oluştur
GET	/api/v2/campaigns	Kampanya listesi
POST	/api/v2/campaigns	Kampanya oluştur
GET	/api/v2/webhooks/config	Webhook yapılandırmasını getir
PUT	/api/v2/webhooks/config	Webhook yapılandırmasını güncelle
GET	/api/v2/webhooks/logs	Webhook teslim günlüklerini görüntüle

---

Yanıt Formatı

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

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 42
  }
}

Hata Yanıtları

{
  "error": "Unauthenticated.",
  "status": 401
}

Durum Kodu	Anlamı
200	Başarılı
201	Oluşturuldu
400	Hatalı İstek (doğrulama hatası)
401	Yetkisiz (geçersiz/eksik API anahtarı)
403	Yasak (yetersiz izinler)
404	Bulunamadı
429	Çok Fazla İstek (hız sınırlandırıldı)
500	Sunucu Hatası

---

Derinlemesine İnceleme

• Kimlik Doğrulama — API anahtarı detayları
• Gönderimler API — geri bildirim oluşturun ve listeleyin
• Ürünler API — ürünleri yönetin
• Kampanyalar API — kampanyaları yönetin
• Webhook'lar — gerçek zamanlı olay bildirimleri