> ## Documentation Index
> Fetch the complete documentation index at: https://docs.detectivision.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Referansı

> Detectivision API Referansı

## Başlarken

Detectivision API'si, içerik moderasyonunu kolaylaştırmak için tasarlanmıştır. API'yi kullanarak, metinleri çeşitli kategorilerde değerlendirebilir ve zararlı içerikler hakkında anında geri bildirim alabilirsiniz.

### Kimlik Doğrulama

Tüm API endpointleri, API anahtarı kullanılarak kimlik doğrulaması gerektirir. API isteğinizin başlığında `API-Key` parametresinde API anahtarınızı sağlamalısınız.

```bash theme={null}
curl -X POST "http://localhost:8787/api/v1/moderation" \
     -H "API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"type": "text_moderation", "input": "örnek metin"}'
```

### Yanıt Formatı

API yanıtları JSON formatında döner. Başarılı yanıtlar 200 OK durum koduyla birlikte gelir ve aşağıdaki yapıya sahip olacaktır:

```json theme={null}
{
  "id": 25,
  "jobId": 122,
  "result": {
    "language": "tr",
    "scores": {
      "NEUTRAL": 0.9886459112167358,
      "SEXUAL": 0.0022032149136066437,
      "HATE": 0.001250135712325573,
      "SELF_HARM": 0.001079669571481645,
      "BAD_HABITS": 0.00073793507181108
    },
    "flags": {
      "NEUTRAL": true,
      "SEXUAL": false,
      "HATE": false, 
      "SELF_HARM": false,
      "BAD_HABITS": false
    }
  },
  "createdAt": 1742201764,
  "updatedAt": 1742201764
}
```

### Kategori Açıklamaları

API'miz şu kategorilerde içerik analizi yapar:

* **NEUTRAL**: İçeriğin zararlı olmadığını gösterir
* **SEXUAL**: Cinsel içerik
* **HATE**: Nefret söylemi
* **SELF\_HARM**: Kendine zarar verme ile ilgili içerik
* **BAD\_HABITS**: Kötü alışkanlıklar (uyuşturucu, alkol vb.) ile ilgili içerik

### API Endpointleri

Tüm mevcut API endpointlerimizi keşfetmek için soldaki menüyü kullanabilirsiniz.