API Dokümantasyonu

API Kullanım Sözleşmesi

AdAnalyzer - Dijital Time Teknoloji Ltd. Şti.

Son Güncellenme: 15 Aralık 2024 | Versiyon: 2.1.0

📑 İçindekiler

📋1. GENEL BİLGİLER

AdAnalyzer API, Google Ads hesaplarınızı programatik olarak yönetmenizi, veri almanızı ve optimizasyon işlemlerini otomatize etmenizi sağlayan RESTful web servisleridir.

📍 Base URL

https://api.adanalyzer.com.tr/v2

🔧 Protokol

HTTPS/TLS 1.3

🔐2. API ERİŞİMİ

2.1 Kimlik Doğrulama

OAuth 2.0 Flow

POST /oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "scope": "read write"
}

API Key Authentication

GET /campaigns
Headers:
  X-API-Key: YOUR_API_KEY
  X-API-Secret: YOUR_API_SECRET

2.2 Token Yönetimi

Access Token

• Geçerlilik: 1 saat
• JWT formatında
• Bearer token olarak kullanım

Refresh Token

• Geçerlilik: 30 gün
• Otomatik yenileme
• Güvenli saklama gerekli

📏3. KULLANIM KURALLARI

✅

İzin Verilenler

• Otomatik raporlama
• Veri senkronizasyonu
• Toplu işlem yapma
• Cache kullanımı
• Webhook entegrasyonu

❌

Yasaklananlar

• DDoS saldırıları
• Veri madenciliği
• Tersine mühendislik
• API anahtarı paylaşımı
• Rate limit aşımı

⚡4. LİMİTLER VE KOTALAR

Rate Limiting

100

İstek/Dakika

Temel Plan

500

İstek/Dakika

Profesyonel Plan

2000

İstek/Dakika

Kurumsal Plan

4.1 Response Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1639094400

4.2 Payload Limitleri

• Maksimum istek boyutu: 10MB
• Maksimum yanıt boyutu: 50MB
• Batch işlem limiti: 100 kayıt
• Pagination limiti: 1000 kayıt/sayfa

🔒5. GÜVENLİK

Güvenlik Standartları

🛡️ Şifreleme

• TLS 1.3 zorunlu
• AES-256 veri şifreleme
• SHA-256 hash algoritması

🔐 Erişim Kontrolü

• IP whitelisting
• CORS politikası
• Request signing

⚠️ Önemli: API anahtarlarınızı asla client-side kodda veya public repositorylerde saklamayın. Environment variables kullanın.

📊6. VERİ FORMATI

6.1 Request Format

POST /campaigns/create
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "name": "Summer Campaign 2024",
  "budget": {
    "amount": 5000,
    "currency": "TRY"
  },
  "targeting": {
    "locations": ["TR"],
    "languages": ["tr"]
  },
  "status": "ENABLED"
}

6.2 Response Format

{
  "success": true,
  "data": {
    "id": "camp_123456",
    "name": "Summer Campaign 2024",
    "created_at": "2024-12-15T10:00:00Z",
    "status": "ENABLED"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": 1639094400
  }
}

⚠️7. HATA YÖNETİMİ

HTTP Status Kodları

✅ Başarılı

200 OK
201 Created
204 No Content

❌ Hatalar

400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

Hata Response Formatı

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "API rate limit exceeded",
    "details": {
      "limit": 100,
      "reset_at": "2024-12-15T10:00:00Z"
    },
    "request_id": "req_xyz789"
  }
}

🔔8. WEBHOOK

Webhook Entegrasyonu

Önemli olayları gerçek zamanlı olarak almanız için webhook desteği sunuyoruz.

📨 Desteklenen Olaylar

• campaign.created
• campaign.updated
• budget.exceeded
• report.ready
• account.suspended

🔐 Güvenlik

• HMAC-SHA256 imza
• Retry mekanizması
• Exponential backoff
• Event deduplication

🔄9. VERSİYONLAMA

API Versiyon Politikası

📌 Mevcut Versiyonlar

v2 (Current)Aktif
v1 (Legacy)Deprecated - 2025 Q2

🔄 Geçiş Süreci

• 6 ay önceden duyuru
• Migration guide sağlama
• Backward compatibility
• Sunset period: 12 ay

🛟10. DESTEK VE SLA

Temel Destek

✓ Email desteği
✓ 48 saat yanıt süresi
✓ Dokümantasyon erişimi
✓ %99 uptime SLA

Profesyonel Destek

✓ Öncelikli email desteği
✓ 24 saat yanıt süresi
✓ Telefon desteği
✓ %99.5 uptime SLA
✓ Teknik danışmanlık

Kurumsal Destek

✓ 7/24 destek
✓ 1 saat yanıt süresi
✓ Dedicated account manager
✓ %99.9 uptime SLA
✓ On-site destek
✓ Custom SLA

💰11. FİYATLANDIRMA

API Kullanım Ücretleri

Plan	İstek/Ay	Rate Limit	Fiyat
Başlangıç	10,000	100/dk	Ücretsiz
Profesyonel	100,000	500/dk	₺999/ay
İşletme	500,000	1000/dk	₺2,999/ay
Kurumsal	Sınırsız	Özel	Özel Fiyat

📌 Not: Fazla kullanım durumunda ek ücretlendirme: ₺0.01 / istek

⚖️12. SORUMLULUKLAR

12.1 AdAnalyzer Sorumlulukları

•API'nin belirtilen SLA seviyesinde erişilebilir olmasını sağlamak
•Güvenlik açıklarını zamanında düzeltmek
•Dokümantasyonu güncel tutmak
•Veri güvenliğini sağlamak

12.2 Kullanıcı Sorumlulukları

•API anahtarlarını güvenli saklamak
•Rate limitlere uymak
•Kullanım koşullarına uymak
•Kötüye kullanımdan kaçınmak

12.3 Sorumluluk Reddi

AdAnalyzer, aşağıdaki durumlardan sorumlu tutulamaz:

• Üçüncü taraf servis kesintileri
• Google Ads API değişiklikleri
• Kullanıcı hatalarından kaynaklanan veri kayıpları
• Mücbir sebepler

API Destek ve İletişim

Teknik Destek:

E-posta: api@adanalyzer.com.tr

Dokümantasyon: docs.adanalyzer.com.tr

Status Page: status.adanalyzer.com.tr

Genel İletişim:

Telefon: +90 553 410 41 36

Adres: Tuzla / İstanbul

Çalışma Saatleri: 09:00 - 18:00

API kullanımı ile ilgili sorularınız için lütfen bizimle iletişime geçin.

← Tüm Sözleşmeler 📚 API Dokümantasyonu