Uygulamalarınıza içeriği “kaynakta” doğrulama kabiliyeti eklemek; yalnızca riskleri azaltmakla kalmaz, kullanıcılarınıza güven veren şeffaf bir deneyim de sağlar. TrustOriginality API, RESTful mimaride tasarlanmış, geliştirici dostu SDK’larla (Python, JavaScript, Java, C#) desteklenen ve ölçeklendirmeye hazır bir doğrulama servisidir. Temel hedef; metin, görsel, ses ve video için tek tip bir programlama arayüzü sunarak doğrulama süreçlerini otomatikleştirmek, sonuçları standart JSON çıktılarıyla teslim etmek ve dileyen müşteriler için zincir kaydını kolaylaştırmaktır.

Temel yetenekler

• JSON Yanıtları: Tüm analizler; skor, metrikler, açıklamalar ve isteğe bağlı blokzincir kanıt özetleriyle birlikte JSON döner.
• Resmi SDK’lar: Python/Node/Java/C# paketleri; kimlik doğrulama, hata yönetimi, yeniden deneme ve pagination için yardımcılar içerir.
• Esnek Lisanslama: Geliştirici deneme, kullanım başı ücretlendirme, hacme göre katmanlar ve kurumsal SLA seçenekleri.

Uç noktalar (örnek)

• POST /v1/verify/text – Metin özgünlük/uyarlama riski analizi.
• POST /v1/verify/image – Görsel adli analiz (EXIF, ELA, artefakt, segment bazlı riskler).
• POST /v1/verify/audio – Sentez/klon tespiti; spektral ve prosodik tutarlılık ölçütleri.
• POST /v1/verify/video – Deepfake ve sahne tutarlılığı; kare başı değerlendirme.
• POST /v1/bulk – Çoklu dosya/URL toplu doğrulama kuyruğu.
• POST /v1/ledger – Doğrulama özetinin blokzincire yazımı (opsiyonel).

JSON yanıt şeması (basitleştirilmiş)

{
  "requestId": "…",
  "contentType": "image|text|audio|video",
  "trustScore": 86,
  "confidenceBand": "high|medium|low",
  "signals": [
    {"name": "exif_consistency", "score": 0.91, "explanation": "…"},
    {"name": "compression_artifacts", "score": 0.72, "explanation": "…"}
  ],
  "recommendations": ["kaynak doğrulaması yap", "alternatif arama"],
  "ledger": {"txId": "…", "timestamp": "…", "network": "…"}
}

Kimlik doğrulama ve güvenlik

API erişimi; anahtar tabanlı kimlik doğrulama veya OAuth 2.0 üzerinden sağlanır. Tüm trafik TLS üzerinden gerçekleşir, hassas alanlar imzalanır. IP kısıtlama, oran sınırları (rate limit), HMAC tabanlı istek imzalama ve idempotency anahtarlarıyla güvenli ve öngörülebilir entegrasyon hedeflenir. Avrupa Birliği veri barındırma seçeneği, veri saklama politikalarının uçtan yönetimi ve denetim günlükleri (audit logs) mevcuttur.

Hata yönetimi ve dayanıklılık

• Standart hata kodları: 4xx (istemci) ve 5xx (sunucu) hata sınıfları; açıklayıcı mesajlar ve hata kodlarıyla birlikte.
• Yeniden deneme stratejileri: SDK’larda gömülü artan gecikmeli (exponential backoff) tekrar denemeler.
• Webhooks: Uzun süren işlerde durum bildirimleri; imzalı geri çağrılarla güvenli bildirim.

Ölçeklenebilirlik ve performans

Mikro servis tabanlı mimari; GPU hızlandırma, bölgesel dağıtım ve esnek kuyruk yönetimi ile yüksek hacimli isteklerde kararlı yanıt süreleri sağlar. Toplu doğrulama uç noktası, haber siteleri veya içerik platformlarının yoğun akışlarını yönetmek için tasarlanmıştır. İçerik başına zaman tahmini ve durum sorgulama uç noktaları, kullanıcı arayüzlerinizde şeffaf deneyim sunmanıza yardımcı olur.

SDK kullanım kolaylıkları

• Dosya ve URL desteği: Yerel dosyayı gönderin veya yalnızca bir URL ile doğrulayın.
• Otomatik tür algılama: İçeriğin MIME türü otomatik algılanır; hatalı türlerde açıklayıcı uyarılar döner.
• İlerleme ve durum olayları: Uzun işlemler için webhook ya da periyodik sorgu yardımcıları.

Kullanım senaryoları

• SaaS Platformları: Kullanıcı yüklemelerini anında tarayarak yanıltıcı içerikleri yayına girmeden durdurun.
• Haber Portalları: CMS entegrasyonu ile editör kaydettiği anda doğrulama çalışsın, rapor CMS’de görünsün.
• İçerik Sağlayıcılar: Kataloglardaki görseller/video için periyodik doğrulama ve zincir kaydı.

Uyum ve audit

API çıktıları; denetim ve hukuk süreçleri için makinece okunabilir JSON paketleri, insan okuyucuya uygun PDF raporları ve zincir referansları içerir. GDPR/AI Act/DSA kapsamında şeffaflık gereksinimlerini desteklemek amacıyla, kullanılan sinyallerin açıklamaları ve model sınırları raporlanır. İstenirse uç nokta bazında müşteri kontrollü veri saklama yapılandırılabilir.

Versiyonlama ve geçiş

Semantik versiyonlama ilkeleri uygulanır. Yeni minör sürümlerde geriye uyumluluk korunur; büyük sürüm geçişlerinde göç rehberleri ve geçiş pencereleri sağlanır. Sürüm bazlı URL’ler ve özellik bayrakları, kademeli geçişi kolaylaştırır.

Sonuç

TrustOriginality API, doğrulamayı uygulamalarınızın doğal bir parçasına dönüştürür. Standart JSON yanıtları, resmi SDK’lar ve esnek lisans katmanları ile ürünlerinize güven ve şeffaflık kazandırırken; otomatik blokzincir kaydı ile kanıt bütünlüğünü uzun vadede garanti altına alırsınız.