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

# Fraud Prevention Data API

Data API ialah pasangan bahagian pelayan kepada [Web SDK](./web-sdk). Gunakannya untuk
menarik keputusan, mengagregat statistik, dan mengeksport data untuk **pelaporan dan
penyelarasan** — menarik angka yang sistem anda sendiri persetujui.

## URL asas

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

## Pengesahan

Semua permintaan Data API disahkan dengan kelayakan aplikasi Fraud Prevention anda,
dihantar sebagai pengepala:

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

::: warning
`X-App-Secret` adalah **bahagian pelayan sahaja**. Jangan sekali-kali dedahkannya kepada
pelayar, aplikasi mudah alih, atau repositori awam. SDK halaman hanya menggunakan
`appKey` awam.
:::

## Titik akhir

### Dapatkan keputusan

Dapatkan keputusan untuk satu lawatan (cth. untuk menyelaras lawatan tertentu).

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

`data` respons ialah objek [`BotVerdict`](./verdict-reference):

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

### Statistik teragregat

Tarik kiraan berbaldi sepanjang julat masa — jumlah, bahagian bot, dan pecahan mengikut
`action`/`level` — untuk papan pemuka dan laporan kualiti.

```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 }
  }
}
```

### Eksport

Eksport baris keputusan per lawatan untuk satu julat masa, untuk penyelarasan luar
talian.

```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
```

Setiap baris membawa pengecam lawatan, cap masa, dan medan keputusan
(`is_bot`, `score`, `level`, `action`), supaya anda boleh mencantumkannya semula kepada
log anda sendiri.

::: tip Penyelarasan per klik
Untuk senario trafik berbayar, satu lawatan boleh diikat semula kepada klik tertentu
yang dihantar supaya dua pihak boleh menyelesaikannya. Itu menggunakan token klik dan
diliputi dalam panduan [Ad fraud](./scenarios/ad-fraud).
:::

## Langkah seterusnya

- [Verdict Reference](./verdict-reference) — medan yang dikembalikan oleh titik akhir ini
- [Web SDK](./web-sdk) — kumpul keputusan pada halaman anda