API Partner

1. Dapatkan API key

API key dibuat oleh admin lewat dashboard admin (tab Partner API). Key berbentuk cp_live_… dan hanya ditampilkan sekali saat dibuat - simpan di tempat aman.

Jangan pernah menaruh API key di kode frontend atau URL publik.

2. Autentikasi

Kirim key lewat header Authorization (disarankan):

Authorization: Bearer cp_live_xxxxxxxxxxxx

atau header x-api-key.

3. Endpoint

GET /api/partner/reports - pencarian laporan publik (masked).

Tanpa q, endpoint mengembalikan katalog laporan publik terbaru (bisa difilter kategori/wilayah) - berguna untuk integrasi daftar.

4. Contoh

curl -H "Authorization: Bearer cp_live_xxxxxxxxxxxx" \
  "https://cekpenipu.example/api/partner/reports?q=1234567890123&tipe=REKENING&limit=5"

Contoh respons:

{
  "data": [
    {
      "reportId": "clx…",
      "judul": "Penipuan jual-beli: transfer tidak dikirim",
      "kategori": "JUAL_BELI",
      "wilayah": "Jakarta Selatan",
      "status": "APPROVED",
      "createdAt": "2026-09-01T08:00:00.000Z",
      "adaKlarifikasi": false,
      "matches": [{ "tipe": "REKENING", "masked": "*********0123" }],
      "identityCount": 1,
      "exact": true,
      "identicalReports": 2
    }
  ],
  "meta": {
    "count": 1,
    "limit": 5,
    "masked": true,
    "apiKeyPrefix": "cp_live_xxxxxx…"
  }
}

exact menandakan query identik dengan identitas laporan; identicalReports = jumlah laporan publik lain yang memuat identitas identik - dua sinyal ini berguna untuk keputusan "kenali lawan transaksi".

5. Batas & privasi

• Rate limit: 120 request per menit per API key.
• Read-only: hanya GET; tidak ada endpoint submit.
• Masked: nilai identitas hanya tampil ter-masking; tanpa data pelapor, bukti, atau kontak.
• Audit: setiap permintaan tercatat (prefix key + waktu) untuk keamanan.

Data laporan adalah informasi crowdsourced - bukan putusan hukum (lihat disclaimer).

Integrasi

Tertarik mengintegrasikan CekPenipu? Hubungi kami lewat halaman kontak - sebutkan platform Anda dan perkiraan volume permintaan agar kami siapkan key dan dukungan.

Partner hanya menerima data publik yang sudah dimoderasi & disamarkan.