---
title: Fraud Prevention — Data API
---

# Fraud Prevention Data API

Data API, [Web SDK](./web-sdk)'nın sunucu tarafı karşılığıdır. Kararları çekmek,
istatistikleri toplamak ve **raporlama ve mutabakat** için veri dışa aktarmak üzere
kullanın — kendi sistemlerinizin üzerinde mutabık kaldığı sayıları çekin.

## Temel URL

```
https://apiv1.captcha.la
```

## Kimlik doğrulama

Tüm Data API istekleri, başlık olarak gönderilen Fraud Prevention uygulama
kimlik bilgilerinizle doğrulanır:

```
X-App-Key:    YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

::: warning
`X-App-Secret` **yalnızca sunucu tarafıdır**. Onu asla tarayıcılara, mobil
uygulamalara veya genel depolara açığa çıkarmayın. Sayfa SDK'sı yalnızca herkese
açık `appKey` değerini kullanır.
:::

## Uç noktalar

### Bir karar getir

Tek bir ziyaretin kararını getirin (ör. belirli bir ziyareti mutabık kılmak için).

```bash
GET /v1/bot/verdict?cid=CID_OF_THE_VISIT
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

Yanıttaki `data`, bir [`BotVerdict`](./verdict-reference) nesnesidir:

```json
{
  "code": 0,
  "data": {
    "is_bot": true,
    "score": 87,
    "level": "high",
    "action": "flag",
    "consistency": { "ok": false },
    "degraded": false
  }
}
```

### Toplu istatistikler

Bir zaman aralığı boyunca kovalanmış sayımları çekin — toplamlar, bot payı ve
`action`/`level` bazında dağılım — kontrol panelleri ve kalite raporları için.

```bash
GET /v1/bot/stats?from=2026-06-01&to=2026-06-30
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

```json
{
  "code": 0,
  "data": {
    "from": "2026-06-01",
    "to": "2026-06-30",
    "total": 124500,
    "bots": 18230,
    "bot_rate": 0.146,
    "by_action": { "record_only": 102100, "flag": 19800, "challenge": 2600 },
    "by_level":  { "low": 100300, "medium": 16900, "high": 6200, "critical": 1100 }
  }
}
```

### Dışa aktarma

Çevrimdışı mutabakat için bir zaman aralığındaki ziyaret başına karar satırlarını
dışa aktarın.

```bash
GET /v1/bot/export?from=2026-06-01&to=2026-06-30&format=csv
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

Her satır, ziyaretin tanımlayıcısını, zaman damgasını ve karar alanlarını
(`is_bot`, `score`, `level`, `action`) taşır; böylece bunu kendi günlüklerinizle
birleştirebilirsiniz.

::: tip Tıklama başına mutabakat
Ücretli trafik senaryolarında, tek bir ziyaret belirli bir teslim edilmiş tıklamaya
geri bağlanabilir; böylece iki taraf bunun üzerinde mutabık kalabilir. Bu, bir
tıklama token'ı kullanır ve [Reklam dolandırıcılığı](./scenarios/ad-fraud) kılavuzunda
ele alınır.
:::

## Sonraki adımlar

- [Karar Referansı](./verdict-reference) — bu uç noktaların döndürdüğü alanlar
- [Web SDK](./web-sdk) — kararları sayfanızda toplayın