Entegrasyon Kılavuzları

EZA-Core Entegrasyon Rehberi

REST API, Python SDK, JavaScript SDK ve webhook entegrasyonu için detaylı kılavuzlar.

Platform Panel üzerinden organizasyonunuzu oluşturun, API anahtarınızı tanımlayın ve EZA-Core'u sistemlerinize entegre edin.

Hızlı Başlangıç

1

API Key Oluştur

Platform Panel'e giriş yaparak organizasyonunuza ait API anahtarını oluşturun

2

İlk İsteği Gönder

Proxy analiz endpoint'ine test isteği göndererek entegrasyonunuzu doğrulayın

Proxy, harici sistemlerin EZA-Core etik analiz altyapısına API üzerinden bağlandığı kurumsal entegrasyon katmanıdır.

3

Response'u İncele

Dönen etik analiz sonuçlarını kontrol edin

API Key Gerekli

Başlamak için Platform Panel üzerinden organizasyonunuza ait API anahtarını oluşturun.

API anahtarları, Platform Panel'de organizasyon bazlı olarak yönetilir ve izlenir.

Entegrasyon Yöntemleri

REST API

HTTP istekleri ile direkt entegrasyon. Tüm diller ve framework'ler için uyumlu. Bu entegrasyon yöntemi, Platform Panel üzerinden oluşturulan API anahtarı ile çalışır.

API kullanımı, organizasyon ve yetkilendirme kuralları çerçevesinde izlenir.

Özellikler

  • HTTP/HTTPS
  • JSON format
  • Tüm endpoint'ler
  • Webhook desteği

Örnek Kod

curl -X POST https://api.ezacore.ai/api/v5/proxy/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Your text here"}'

Python SDK

Resmi Python SDK ile hızlı entegrasyon. Async/await desteği ile performanslı. Platform Panel üzerinden oluşturulan API anahtarı ile kullanılır.

API kullanımı, organizasyon ve yetkilendirme kuralları çerçevesinde izlenir.

Özellikler

  • pip install ezacore
  • Async/await
  • Type hints
  • Error handling

Örnek Kod

from ezacore import EZACore

client = EZACore(api_key="YOUR_API_KEY")
result = await client.proxy.analyze("Your text here")
print(result.score)

JavaScript/TypeScript SDK

Node.js ve browser için TypeScript desteği ile modern entegrasyon. Platform Panel üzerinden oluşturulan API anahtarı ile çalışır.

API kullanımı, organizasyon ve yetkilendirme kuralları çerçevesinde izlenir.

Özellikler

  • npm install @ezacore/sdk
  • TypeScript
  • Browser/Node.js
  • Promise-based

Örnek Kod

import { EZACore } from '@ezacore/sdk';

const client = new EZACore({ apiKey: 'YOUR_API_KEY' });
const result = await client.proxy.analyze('Your text here');
console.log(result.score);

Webhook Entegrasyonu

Gerçek zamanlı olay bildirimleri için webhook endpoint'inizi yapılandırın. Webhook ayarları, Platform Panel üzerinden yapılandırılır ve doğrulanır.

1

Endpoint Oluştur

Webhook'ları alacak HTTPS endpoint'inizi hazırlayın

2

Platform Panel'de Yapılandır

Webhook URL'inizi Platform Panel üzerinden yapılandırın ve doğrulayın

3

İmza Doğrulama

X-EZA-Signature header'ını kullanarak imzayı doğrulayın

4

Event Handling

Gelen event'leri işleyin ve sisteminize entegre edin

En İyi Uygulamalar

Güvenlik

  • API key'lerinizi environment variable'larda saklayın
  • HTTPS kullanın, asla HTTP üzerinden API key göndermeyin
  • Webhook imzalarını mutlaka doğrulayın
  • Rate limit'leri aşmamak için retry logic kullanın
  • API anahtarları ve webhook ayarları organizasyon bazlıdır ve Platform Panel üzerinden merkezi olarak yönetilir

Performans

  • Async/await veya Promise kullanarak non-blocking istekler yapın
  • Batch işlemler için toplu endpoint'leri kullanın
  • Connection pooling kullanın
  • Gereksiz isteklerden kaçının, cache mekanizmaları ekleyin

Hata Yönetimi

  • Tüm HTTP status kodlarını kontrol edin
  • 429 (Rate Limit) durumunda Retry-After header'ına göre bekleyin
  • Exponential backoff ile retry mekanizması ekleyin
  • Hataları loglayın ve monitoring sisteminize entegre edin

Kod Örnekleri & Kaynaklar

GitHub Repository

Hazır kod örnekleri, snippet'ler ve entegrasyon template'leri için GitHub repository'mizi ziyaret edin.

Repository'yi Görüntüle

API Referansı

Tüm endpoint'ler, parametreler ve response formatları için detaylı API dokümantasyonu.

API Dokümantasyonu

Sorularınız mı var?

Entegrasyon sürecinde yardıma mı ihtiyacınız var? İletişime geçin.

Platform Panel'e Gitİletişime Geç

Entegrasyon, yetkilendirme ve etik izleme süreçleri Platform Panel üzerinden yürütülür.