Birleşik Çoklu Kontrol İstekleri

Her kontrol için ayrı bir API çağrısına ihtiyacınız yok. Tek bir POST /api/v2/check isteği, karma içerik üzerinde metin, görsel, kötü kelime ve antivirüs kontrollerini birlikte çalıştırabilir ve her biri için sonuç içeren tek bir yanıt döndürebilir. Bu, açıklama metni, görseli ve eki olan bir gönderiyi tek seferde denetlemenin en verimli yoludur.

Neden her şeyi tek çağrıda denetlemelisiniz?

Bir kullanıcı gönderimi genellikle bir pakettir: metin, medya ve bağlantılar bir arada gelir. API'yi her parça için ayrı ayrı çağırmak daha fazla gidiş geliş, daha yüksek gecikme ve daha fazla kota tüketimi demektir. Tek bir birleşik istek, etkinleştirilmiş kontrolleri paralel çalıştırır ve işlem yapabileceğiniz tek bir karar sunar.

Birden fazla kontrolü aynı anda nasıl çalıştırırım?

Her içerik türünü content içine koyun, istediğiniz kontrolleri settings içinde etkinleştirin ve her kontrole ait sonuçları okuyun. Etkinleştirilen her kontrol, eşleşen içerik üzerinde çalışır.

curl -X POST https://api.discuse.com/api/v2/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "content": {
      "text": "Great deal, check my profile!",
      "image_urls": ["https://example.com/post-image.jpg"],
      "document_urls": ["https://example.com/attachment.pdf"]
    },
    "settings": {
      "check_spam": true,
      "check_sentiment": true,
      "check_images": true,
      "check_antivirus": true
    }
  }'

Yanıt

{
  "has_violations": true,
  "cached": false,
  "results": {
    "hits": true,
    "spamfinder": { "label": "spam", "confidence": 0.91, "is_spam": true, "hit": true },
    "sentiment": { "is_negative": false, "is_toxic": false, "score": 0.1, "hit": false },
    "images": { "status": "OK", "porn": 0.02, "sexual": 0.05, "neutral": 0.93, "hit": false },
    "antivirus": { "status": "OK", "hit": false, "details": [] }
  },
  "usage": {
    "api_requests_used": 530,
    "api_requests_limit": 10000,
    "api_requests_remaining": 9470
  }
}

Birleşik sonucu nasıl okumalıyım?

Genel karar için has_violations değerini kullanın, ardından hangi kontrolün neden tetiklendiğini görmek için her bir results.<check>.hit alanına bakın:

Alan	Anlamı
has_violations	Etkinleştirilmiş herhangi bir kontrol içeriği işaretlediyse True — tek satırlık kararınız
results.hits	Sonuç nesnesinin içindeki aynı genel sinyal
results.spamfinder.hit	Spam tetiklendi (eşiklere duyarlıdır; ham is_spam yerine hit üzerinden karar verin)
results.sentiment.hit	Eşiklerinizin üzerinde toksik/negatif duygu
results.images.hit	Bir görsel NSFW eşiğinizi aştı
results.antivirus.hit	Bir belgede zararlı yazılım bulundu
results.badwords.hit	Yapılandırılmış bir kötü kelimeyle eşleşme oldu
results.skipped_features	İstenen ancak çalıştırılmayan kontroller (ör. kotası tükenmiş bir özellik)

Yalnızca etkinleştirdiğiniz (ve eşleşen içeriğe sahip olan) kontroller results içinde görünür. Üzerinde işlem yapacak içerik olmayan bir kontrol — image_urls olmadan check_images gibi — basitçe çalıştırılmaz.

Hangi içerik hangi kontrolle eşleşir?

Kontrol	Okuduğu içerik
check_sentiment, check_spam, check_badwords, check_language	content.text
check_images	content.image_urls
check_antivirus	content.document_urls

Tek bir istek en fazla 10 görsel URL'si, 5 belge URL'si ve 10.000 karaktere kadar metin taşıyabilir. Bir gönderimin parçalarını çağrılara bölmek yerine birlikte gönderin.

Kısmi hatalarda ne olur?

Bir kontrol hata verirse (örneğin bir görsel URL'sine ulaşılamıyorsa) diğerleri yine de döner — başarılı olan sonuçları alırsınız ve başarısız kontrol, tüm isteği başarısız kılmak yerine hatasını/boş sonucunu raporlar. Her kontrol için ayrı karar verin: doğrulanmış bir hit durumunda engelleyin ve hata veren bir kontrolün açık şekilde geçmesine mi yoksa inceleme kuyruğuna alınmasına mı karar verin.

En iyi uygulamalar

Yalnızca ihtiyacınız olanı etkinleştirin

Etkinleştirilen her kontrol ek iş yükü getirir. Gerçekten aldığınız içerikle eşleşen kontrolleri açın — yalnızca metin içeren mesajlarda check_antivirus çalıştırmanın bir faydası yoktur.

Önce tek karar, sonra ayrıntıya inin

Hızlı akış için önce has_violations üzerinden dallanın, ardından yalnızca hangi kontrolün tetiklendiğini bilmeniz gerektiğinde (kayıt tutma, itirazlar veya doğru inceleyiciye yönlendirme için) results alanını inceleyin.

const res = await check(content, settings);
if (!res.has_violations) return allow();

const r = res.results;
if (r.antivirus?.hit) return quarantine();      // most severe first
if (r.images?.hit)    return blockMedia();
if (r.spamfinder?.hit || r.badwords?.hit) return shadowban();
return queueForReview(r);

İlgili

• Metin Analizi — duygu, spam ve metin sonucu alanları
• Görsel NSFW Tespiti — görsel puanlama ve eşikler
• Dosya Antivirüs Taraması — belge zararlı yazılım kontrolleri
• Hata ve Yanıt Kodları — yanıt zarfı ve kota yönetimi