Public API

ProofKit menyediakan REST API untuk mengelola project dan testimoni secara terprogram — cocok untuk integrasi dengan sistem internal, CRM, atau otomatisasi.

Fitur ini tersedia untuk paket Business. Autentikasi via API key (Bearer token).

Mendapatkan API key

1. Dashboard → API Keys (kelola kunci).
2. Buat key baru — salin nilainya (hanya ditampilkan sekali).
3. Gunakan sebagai header Authorization: Bearer <KEY>.

Endpoint

Method	Endpoint	Fungsi
GET	/api/v1/projects	Daftar project milik Anda
POST	/api/v1/projects	Buat project baru
GET	/api/v1/projects/{id}	Detail project
GET	/api/v1/projects/{id}/widgets	Widget milik project
GET	/api/v1/testimonials	Daftar testimoni
GET	/api/v1/testimonials/{id}	Detail testimoni

Contoh request

curl -H "Authorization: Bearer pk_live_xxx" \
  https://proofkit.web.id/api/v1/projects

{ "projects": [ { "id": "...", "name": "Toko Saya", "slug": "toko-saya" } ] }

Batas

• Rate limit: 300 request/menit per API key.
• Key bisa dicabut (revoke) kapan saja dari dashboard — request dengan key yang dicabut ditolak (401).

Format error

Error dikembalikan dengan kode status HTTP standar:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Token API tidak valid.",
    "context": "auth"
  }
}

Kode	HTTP	Arti
UNAUTHORIZED	401	Key tidak valid / kedaluwarsa / dicabut
RATE_LIMITED	429	Melebihi 300 request/menit
VALIDATION_ERROR	422	Input tidak valid
PLAN_LIMIT_EXCEEDED	402	Batas plan tercapai (mis. jumlah project)