EZA-Core API Referansı
EZA-Core API, organizasyon bazlı etik analiz entegrasyonları için tasarlanmıştır. Tüm API erişimleri, EZA Platform üzerinden oluşturulan organizasyonlar ve Proxy katmanı üzerinden gerçekleştirilir.
EZA-Core API, v5 mimarisi üzerine inşa edilmiştir. Tüm güncel entegrasyonlar /api/v5 namespace'i üzerinden gerçekleştirilir.
Bu dokümantasyon, kurumsal entegrasyonlar için geçerli olan API yüzeyini kapsar.
API Genel Bakış
Base URL
https://api.ezacore.aiVersiyonlama
API versiyonlama URL path'inde yapılır. Şu anda v5 aktif.
Content-Type
Tüm request'ler application/json formatında olmalıdır.
Çalışma Modeli
EZA API çağrıları, bireysel anahtarlar üzerinden değil; Platform Dashboard'ta tanımlanan organizasyon, kullanım amacı ve etik politika setleri üzerinden değerlendirilir.
Authentication
API Key Authentication
API anahtarları, EZA Platform Dashboard üzerinden organizasyon bazlı olarak oluşturulur ve yönetilir. Her istek, Authorization header'ında API key ile yapılır.
Authorization: Bearer YOUR_API_KEYToken Management
API anahtarları organizasyona bağlıdır ve erişim yetkileri platform üzerinden kontrol edilir.
Proxy API
Proxy
Proxy endpoint'i, LLM veya kullanıcı çıktılarının etik etkilerini analiz eder ve görünür kılar. İçeriği değiştirmez, engellemez veya sansürlemez.
/api/v5/proxy/analyzeLLM veya kullanıcı çıktılarının etik etkilerini analiz eder ve görünür kılar
Parametreler:
input (string)llm_response (string, optional)model (string, optional)
Rate Limits
Rate limit'ler organizasyon bazlı uygulanır. Limit aşımı durumunda 429 hatası ve Retry-After header'ı döner.
Hata Yönetimi
Bad Request
Geçersiz request formatı veya eksik parametreler
Unauthorized
Geçersiz veya eksik API key
Forbidden
API key bu endpoint için yetkisiz
Rate Limit Exceeded
Rate limit aşıldı, retry-after header'ına bakın
Internal Server Error
Sunucu hatası, tekrar deneyin
Service Unavailable
Servis geçici olarak kullanılamıyor
Hazır mısınız?
EZA'yı kurumsal kullanım için entegre etmek üzere organizasyonunuzu oluşturun ve Proxy entegrasyonunu başlatın.