REST API dan Endpoint Publik

Dokumen ini merangkum dua surface backend yang aktif di Biver. Gunakan API worker untuk integrasi eksternal berbasis API key, lalu gunakan Next.js app routes untuk interaksi publik yang berjalan langsung dari landing page atau dashboard.

Biver Builders Hub

Pemilik akun dapat membuka dashboard Biver untuk melihat informasi komunitas dan pembaruan produk.

Pilih surface yang tepat

Format respons

• Endpoint worker mengikuti envelope standar: success, data, dan meta untuk paginasi.
• Endpoint app tidak memakai satu envelope global. Beberapa route mengembalikan success, beberapa hanya error, dan POST /api/analytics/track selalu merespons 204.
• Status Partial berarti route aktif tetapi masih punya batas implementasi. Status Placeholder berarti route aktif namun hasilnya masih dummy atau belum menyimpan data final.

Contoh cepat

List pages via API worker

curl -X GET 'https://api.biver.id/v1/pages?page=1&limit=20' \
  -H 'X-API-Key: bvr_live_xxxxx'

Submit form dari landing page

curl -X POST 'https://biver.id/api/forms/FORM_ID/submit' \
  -H 'Content-Type: application/json' \
  -d '{
    "payload": {
      "name": "Budi",
      "email": "budi@example.com",
      "message": "Saya ingin demo"
    }
  }'

Kirim analytics beacon

curl -X POST 'https://biver.id/api/analytics/track' \
  -H 'Content-Type: application/json' \
  -d '{
    "pageId": "PAGE_UUID",
    "sessionId": "sess_12345678",
    "eventType": "page_view"
  }'

Cloudflare API Worker

Surface ini dipakai untuk integrasi programmatic berbasis API key dan berada di domain api.biver.id.

Base URL: https://api.biver.id

Dokumentasi dan kesehatan

Pages

Sections

Products

Forms

Gallery

AI helper routes

Domains

Subdomains

Workspace

Tracking worker API

Wallet (Saldo Biver)

Analytics (Omzet dan Traffic)

Checkout (Riwayat Order)

Checkout (Kupon)

Checkout (Order Bump)

Checkout (Pengiriman dan COD)

Next.js App Routes

Surface ini dipakai oleh dashboard atau published landing page di domain utama Biver.

Base URL: https://biver.id

Image generation app routes

Landing page public routes

MCP Server

Worker yang sama menyediakan MCP server stateless di POST https://mcp.biver.id/mcp. Transport-nya Streamable HTTP dengan JSON-RPC 2.0, tanpa SSE dan tanpa Mcp-Session-Id. Request GET dijawab 405.

curl -X POST 'https://api.biver.id/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer bvr_live_xxxxx' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Daftar tool, contoh prompt, dan cara menghubungkan: /docs/claude-connector. Tutorial lengkap: /docs/mcp-server.

Catatan implementasi penting

• PATCH /v1/workspace/settings, PATCH /v1/workspace/branding, dan PATCH /v1/workspace/seo adalah kontrak aktif. Docs lama yang masih menulis PUT sudah tidak berlaku.
• POST /v1/forms/submit adalah route worker yang butuh API key. Form publik landing page memakai POST /api/forms/:id/submit di app.
• Worker forms sekarang mengembalikan fields dan settings ter-parse, tetapi tetap mempertahankan fieldsJson dan settingsJson untuk kompatibilitas.
• Gallery menerima upload di POST /v1/gallery dan alias POST /v1/gallery/upload.
• Pipeline image memakai satu capability tetap cx/gpt-5.5-image, Queue Cloudflare, dan pola async submit + polling task. Client tidak memilih provider, model, size, resolution, atau jumlah hasil.
• Seluruh route sections worker yang memodifikasi data (POST /v1/sections, POST /v1/sections/bulk, PATCH /v1/sections/:id, DELETE /v1/sections/:id, POST /v1/sections/reorder) memakai pageId sebagai query wajib.
• AI page dan section melalui API Worker memanggil action internal yang sama dengan dashboard, memakai model teks tetap dan kuota workspace yang sama.
• Route pengelolaan /api-keys tidak dipublikasikan oleh API Worker. Buat dan cabut credential hanya dari dashboard Biver.
• GET /v1/tracking/events dan penyimpanan event worker belum final. Untuk analytics live landing page, acuan utamanya tetap POST /api/analytics/track.

Copywriting Style Options untuk AI Generation

Chat Biver AI di builder (POST /api/ai/chat, stream SSE) memilih salah satu dari 3 framework copywriting profesional berikut untuk setiap halaman:

Alex Hormozi ($100M Offers)

• Tone: Confident, logical, no fluff, value-driven
• Struktur: Magnetic Headline → Reason Why (Scarcity/Urgency) → Value Equation Breakdown → Offer Stack (main + 3 bonus) → Unbeatable Guarantee → CTA
• Cocok untuk: Direct-response offers, high-ticket products, bisnis jasa dengan value proposition jelas

Russell Brunson (Hook, Story, Offer)

• Tone: Inspirational, high energy, storytelling, empathetic
• Struktur: The Hook (Headline) → The Story (Backstory, The Wall, The Epiphany, The Plan) → The Offer (product list + The Stack) → The Call To Action
• Cocok untuk: Personal brand, coaching, courses, produk berbasis transformasi

Dane Maxwell (The Copywriting Checklist)

• Tone: Clear, customer-focused, benefit-driven
• Struktur: Instant Clarity Headline → Declare Problem → Present Solution → Borrow Credibility → Social Proof → Testimonials → Clear CTA → Reverse Risk → Price Anchoring → FAQ
• Cocok untuk: SaaS, produk teknologi, B2B services, produk yang butuh trust-building

Payload chat builder

Route ini dipakai panel chat di builder dengan sesi login, bukan lewat API key. Satu pesan memakai satu kuota aksi AI.

{
  "workspaceId": "WORKSPACE_ID",
  "pageId": "PAGE_ID",
  "messages": [{"role": "user", "content": "Buat landing page kopi susu gula aren di Bandung"}],
  "page": {"title": "", "sections": [], "settings": {"whatsappNumber": "6281234567890"}}
}

Respons berupa event SSE: text_delta, plan, section_start, section_complete, section_error, remove_sections, reorder_sections, page_update, suggestions, lalu done atau error.