Lompat ke konten
White page Kit
Bahasa Indonesia

Documentación API

Erstellen Sie Whitepage-Websites, verfolgen Sie ihren Fortschritt und laden Sie die Dateien aus Ihrem eigenen Code, mit einem No-Code-Tool oder einfach durch Fragen eines AI-Assistenten herunter. Jede Anfrage ist JSON über HTTPS.

Cómo funciona

Tres pasos, sin importar cómo te conectes:

  1. Crea una clave API Inicia sesión, abre las claves API en el panel y crea una clave. Funciona como una contraseña para tu cuenta, así que mantenla privada.
  2. Solicita un sitio Envía un título y un idioma, y si quieres, el tema, la audiencia y las palabras clave. El precio de generación se toma de tu saldo y el sitio comienza a construirse.
  3. Recoge tu sitio Normalmente está listo en minutos. Revisa su estado, o déjanos llamar a tu URL cuando termine, luego prévisualiza, edita y descarga los archivos.

Elige cómo te conectas

No-code araçları: HTTP isteği gönderebilen herhangi bir şey (Zapier, Make, n8n, bir elektronik tablo skripti) aynı çağrıları yapabilir. POST /sites bir site başlatır; GET /sites/{uuid} zamanlayıcıda veya callback_url ile ne zaman tamamlandığını bildirir. API anahtarını Authorization başlığına koyun.

Anahtar terimler

Site
Tüm sayfalarıyla birlikte oluşturulmuş bir web sitesi. Bir uuid ile tanımlanır.
Estado
Oluşturulurken beklemede, hazır olduğunda tamamlandı, başarısız olursa hata. Başarısız olan bir site otomatik olarak geri ödenir.
API anahtarı
Bir isteğin hesabınızdan geldiğini kanıtlayan gizli bir dizgi. Anahtarları kontrol panelinde oluşturup iptal edebilirsiniz.
Saldo
Hesabınızdaki ön ödemeli para. Bir site oluşturmak, oluşturma fiyatını buradan ayırır.
Geri arama
Sitenin bitmesiyle bir kez bizim tarafımızdan çağrılan sizin URL'niz, böylece sürekli kontrol etmek zorunda kalmazsınız.
İdempotentlik anahtarı
Bir isteğe eklediğiniz etiket, böylece iki kez gönderilmesi durumunda iki site oluşturmaz veya ücretlendirme yapmaz.

AI asistanlarıyla kullanın

Bir AI asistanını bağlayın ve basitçe şunu söyleyin: "Diş kliniğim için bir site yap, Türkçe." Asistan aynı API'yi sizin hesabınız altında çağırır. Kontrol sizde kalır: bir site oluşturmak bakiye gerektirir ve iyi asistanlar bunu yapmadan önce sizden onay ister.

Söyleyebileceğiniz şeyler

  • How much balance do I have, and what does one site cost?
  • Which design kits suit a bakery?
  • Create a one-page site for Alder House, a quiet harbour guesthouse, in English.
  • Is my site ready? Send me the preview link.

Connect over MCP (Claude, Cursor and more)

MCP is the open standard assistants use to call outside tools. Point your assistant at the MCP URL and give it your API key as a Bearer token.

Claude Code

bash

claude mcp add --transport http whitepagekit https://whitepagekit.com/api/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "whitepagekit": {
      "url": "https://whitepagekit.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WPK_API_KEY}"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "whitepagekit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://whitepagekit.com/api/v1/mcp",
               "--header", "Authorization:${WPK_AUTH}"],
      "env": { "WPK_AUTH": "Bearer YOUR_API_KEY" }
    }
  }
}

Raw JSON-RPC

curl

curl -X POST https://whitepagekit.com/api/v1/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_account","arguments":{}}}'

Claude Desktop reaches remote servers through the mcp-remote bridge, which needs Node.js.

ChatGPT (custom GPT)

  1. In ChatGPT create a GPT, open Configure and choose Create new action.
  2. Choose Import from URL and paste https://whitepagekit.com/api/v1/openapi.json?profile=assistant. This trimmed schema holds only the six assistant tools.
  3. Under Authentication choose API key, set Auth Type to Bearer and paste your API key.
  4. ChatGPT asks you to confirm requests that change something, so you stay in control of anything that costs balance.

Schema URL

https://whitepagekit.com/api/v1/openapi.json?profile=assistant

OpenAI API (MCP tool)

The Responses API can use the MCP URL as a remote tool. require_approval keeps a human in the loop.

Python

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="YOUR_MODEL",
    tools=[{
        "type": "mcp",
        "server_label": "whitepagekit",
        "server_url": "https://whitepagekit.com/api/v1/mcp",
        "headers": {"Authorization": "Bearer YOUR_API_KEY"},
        "require_approval": "always",
    }],
    input="What does one site cost, and which design kits suit a bakery?",
)
print(response.output_text)

Your own tool loop (function calling)

If you run the model loop yourself, fetch ready-made tool schemas and run each tool call against the matching REST endpoint. Formats: openai (Responses API), openai-chat, anthropic and mcp.

curl

curl "https://whitepagekit.com/api/v1/ai-tools?format=openai"   # or openai-chat, anthropic, mcp

The six tools

The six tools
Herramienta Qué hace Llamada REST Costo
get_account Muestra tu saldo y cuánto cuesta un sitio. GET /me Gratis
list_languages Enumera los idiomas en los que un sitio puede estar escrito. GET /languages Gratis
list_themes Busca los kits de diseño por tema o estilo. GET /themes Gratis
create_site Comienza a generar un sitio y toma el precio de generación de tu saldo. POST /sites Usa saldo
get_site Muestra un sitio: progreso, enlace de vista previa y enlace de descarga. GET /sites/{uuid} Gratis
list_sites Lista tus sitios, los más nuevos primero. GET /sites Gratis

Dale estos documentos a cualquier IA

Esta página también está disponible como Markdown plano, ideal para pegar en un chat o entregarla a un asistente de codificación:

Markdown

https://whitepagekit.com/api/v1/docs.md

Un prompt que puedes pegar

Prompt

You can build websites with the White Page Kit API. Read https://whitepagekit.com/api/v1/docs.md first.
My API key is in the environment variable WPK_API_KEY.
Check my balance and the price, then create a site for my dental clinic in Izmir, in Turkish,
wait until it is ready and send me the preview link.

Seguridad y costo

  • Solo create_site consume saldo. Las otras cinco herramientas solo leen.
  • Usa una clave separada para asistentes. Asígnale una fecha de expiración y un límite de tasa en el panel, y revócala cuando quieras.
  • Los asistentes no pueden eliminar sitios, cambiar configuraciones ni manejar pagos: esas rutas no están expuestas como herramientas.
  • Establece idempotency_key en create_site para que un reintento nunca cobre dos veces. Las generaciones fallidas se reembolsan.
  • Las páginas de edición, las imágenes de referencia y las descargas ZIP permanecen en la REST API y el panel de control.

Inicio rápido

Tres llamadas te llevan desde un breve resumen hasta un sitio descargable. Reemplaza YOUR_API_KEY con una clave del panel de control.

1. Inicia una generación

POST /sites valida tu resumen, reserva el precio de la generación de tu saldo y responde de inmediato.

curl

curl -X POST https://whitepagekit.com/api/v1/sites \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-attempt-1" \
  -d '{"title":"Alder House","lang":"en","sector":"guesthouse","keywords":"quiet stay, harbour","structure":"onepage"}'

La respuesta es 202 Accepted con el nuevo sitio:

202 Accepted

{
  "success": true,
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "title": "Alder House",
    "lang": "en",
    "preview_url": null,
    "download_url": null
  }
}

2. Consulta el estado

Consulta GET /sites/{uuid} aproximadamente cada 5-20 segundos hasta que el estado sea done o error, o usa una URL de devolución de llamada en lugar de consultar.

curl

curl https://whitepagekit.com/api/v1/sites/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"

3. Descarga los archivos

Un sitio terminado se descarga como un ZIP. format es multi o onepage; assets es inline o externo.

curl

curl -o site.zip \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://whitepagekit.com/api/v1/sites/550e8400-e29b-41d4-a716-446655440000/download?format=multi&assets=inline"

El mismo flujo en código

PHP

<?php
$ch = curl_init('https://whitepagekit.com/api/v1/sites');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('WPK_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: order-1042-attempt-1',
    ],
    CURLOPT_POSTFIELDS => json_encode(['title' => 'Alder House', 'lang' => 'en']),
]);
$site = json_decode(curl_exec($ch), true)['data'];
do {
    sleep(5);
    $ch = curl_init('https://whitepagekit.com/api/v1/sites/' . $site['uuid']);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('WPK_API_KEY')]]);
    $site = json_decode(curl_exec($ch), true)['data'];
} while ($site['status'] === 'pending');

Node.js

const headers = {
  Authorization: `Bearer ${process.env.WPK_API_KEY}`,
  'Content-Type': 'application/json',
  'Idempotency-Key': 'order-1042-attempt-1',
};
let { data: site } = await (await fetch('https://whitepagekit.com/api/v1/sites', {
  method: 'POST', headers,
  body: JSON.stringify({ title: 'Alder House', lang: 'en' }),
})).json();
while (site.status === 'pending') {
  await new Promise((r) => setTimeout(r, 5000));
  ({ data: site } = await (await fetch(`https://whitepagekit.com/api/v1/sites/${site.uuid}`, { headers })).json());
}

Python

import os, time, requests

headers = {"Authorization": f"Bearer {os.environ['WPK_API_KEY']}",
           "Idempotency-Key": "order-1042-attempt-1"}
site = requests.post("https://whitepagekit.com/api/v1/sites", headers=headers,
                     json={"title": "Alder House", "lang": "en"}).json()["data"]
while site["status"] == "pending":
    time.sleep(5)
    site = requests.get(f"https://whitepagekit.com/api/v1/sites/{site['uuid']}", headers=headers).json()["data"]

Autenticación

Envía una clave API con cada solicitud excepto el documento OpenAPI. Mantén las claves en tu servidor; nunca las pongas en el código del navegador ni en URLs.

  • Encabezado: Authorization: Bearer YOUR_API_KEY, o X-API-Key: YOUR_API_KEY.
  • Crea, revoca y limita la tasa de las claves en el panel. Las claves pueden tener una fecha de expiración y una lista blanca de IPs.
  • Solo ves tus propios sitios. Un sitio propiedad de otra cuenta devuelve 404 not_found.
  • Agrega ?lang=xx o Accept-Language para localizar los mensajes de error.

Idempotencia

Envía Idempotency-Key (8–80 caracteres: letras, dígitos, _ y -) en POST /sites. Repetir la misma clave devuelve el sitio original y nunca cobra dos veces, por lo que reintentos tras un tiempo de espera son seguros. Usa una clave nueva para reintentar una generación fallida.

Webhooks (callbacks)

Pass callback_url to POST /sites (or set an account webhook) and receive one JSON POST when the job finishes (site.completed) or fails (site.failed).

POST callback_url

{
  "event": "site.completed",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "status": "done",
  "site_title": "Alder House",
  "lang": "en",
  "domain": null,
  "created_at": "2026-01-15T09:30:00+00:00",
  "preview_url": "https://whitepagekit.com/preview?uuid=550e8400-…"
}

When the account has a webhook secret, every request carries X-Webhook-Signature: sha256=<hex>, an HMAC-SHA256 of the raw body. Verify it before parsing the JSON, using a constant-time comparison:

PHP

$raw = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $raw, $webhookSecret);
if (!hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}

Node.js

import crypto from 'node:crypto';

const expected = 'sha256=' + crypto
  .createHmac('sha256', webhookSecret).update(rawBody).digest('hex');
const received = req.get('x-webhook-signature') ?? '';
const ok = received.length === expected.length
  && crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

Each callback is attempted once with a 10-second timeout and is not retried. Treat it as a notification and reconcile with GET /sites/{uuid}. Handle repeats idempotently by uuid and event. Private-network targets are rejected.

Ошибки

Every response uses an envelope. Errors carry a stable code, a localized message and, for validation errors, the failing field.

JSON

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "...",
    "details": { "field": "title" }
  }
}
Ошибки
HTTPError codes
400 validation_error, invalid_json, invalid_webhook_url
401 missing_api_key
402 insufficient_balance
403 api_disabled, invalid_api_key, forbidden
404 not_found, route_not_found
405 method_not_allowed
409 site_not_ready, conflict, edits_reset_required
413 payload_too_large
415 unsupported_media_type
429 rate_limited
500 internal_error, export_failed
502 generation_failed

Limits

Limits
Limit Value
Requests per key 60 per minute by default (configurable per key, 0 = unlimited). Repeated invalid keys from one IP get 429 with Retry-After.
Request body 2 MB; POST /sites with reference images up to 162 MB; editor saves up to 4 MB.
Reference images Up to 12 PNG, JPEG or WEBP images (base64 or data URL), at most 10 MB each.
Editor page content HTML up to 500,000 characters, CSS up to 100,000. Scripts and event handlers are removed.
Site images PNG, JPEG, WEBP or GIF, 5 MB each, up to 200 per site.
Site title Título del sitio 1–200 caracteres.

Editor API

Todo lo que el editor del panel hace está disponible para tus sitios terminados: contenido de la página, plan de página y sección, estilo, título/tema/diseño/estructura, seguimiento e imágenes. Las ediciones de página reemplazan la página; DELETE restaura la página generada.

curl

# Load, change and save a page
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://whitepagekit.com/api/v1/sites/UUID/editor?page=index"
curl -X PATCH https://whitepagekit.com/api/v1/sites/UUID/editor \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"index","html":"<main>…</main>","css":""}'
# Restore the generated page
curl -X DELETE -H "X-API-Key: YOUR_API_KEY" \
  "https://whitepagekit.com/api/v1/sites/UUID/editor?page=index"

La edición necesita un sitio completado (409 site_not_ready de otra forma). Cambiar tema, diseño o estructura sobre páginas editadas devuelve 409 edits_reset_required a menos que reset_edits sea true. La edición es gratuita.

Referencia de endpoint

Generado desde el documento OpenAPI, por lo que siempre coincide con la API en vivo. Las rutas son relativas a la URL base.

Cuenta

  • GET /me

    Get the authenticated account

  • GET /transactions

    List account balance transactions

Catálogo

  • GET /languages

    List enabled supported languages

  • GET /themes

    List site themes

  • GET /layouts

    List enabled layouts

Sitios

  • GET /sites

    List the authenticated account's sites

  • POST /sites

    Start site generation

  • GET /sites/{uuid}

    Get site status and refresh generation state

  • DELETE /sites/{uuid}

    Delete a terminal site and its generated data — Pending, queued and running generation jobs cannot be deleted. Wait for done or error; active deletion returns 409 conflict without refunding or removing the job.

  • GET /sites/{uuid}/download

    Download a completed site archive

IA y automatización

  • GET /ai-tools

    Function-calling tool schemas — The same six tools the MCP endpoint offers, as JSON schemas for your own tool loop. format is openai (Responses API), openai-chat (Chat Completions), anthropic or mcp. Public; no response envelope.

  • GET /docs.md

    Documentation as Markdown — The developer guide, endpoint reference and AI integration guide as one Markdown file, written for language models and quick copy-paste. Public.

  • POST /mcp

    Model Context Protocol endpoint — MCP over Streamable HTTP (JSON-RPC 2.0, one JSON reply per POST). Methods: initialize, ping, tools/list, tools/call. Tools: get_account, list_languages, list_themes, create_site (paid), get_site, list_sites. Authenticate with the same API key; point an MCP client at this URL.

Editor

  • GET /sites/{uuid}/editor

    Load a page for editing — Editor access for the site owner's API key; mirrors the dashboard editor. Only completed sites (409 site_not_ready otherwise).

  • PATCH /sites/{uuid}/editor

    Save a page's edited content — Replaces the page content and CSS. html must be non-empty (use DELETE to restore the generated page); scripts, event handlers and javascript: URLs are removed, HTML is limited to 500000 and CSS to 100000 characters, request body to 4 MB. Returns the saved page as GET does.

  • DELETE /sites/{uuid}/editor

    Restore a page's generated content — Discards the page's saved edits. Returns the regenerated page.

  • GET /sites/{uuid}/editor/canvas

    Get editing canvas data — Stylesheet, Tailwind theme, body class, direction, section blocks, icons and sample copy an external visual editor needs to render the page like the dashboard editor.

  • GET /sites/{uuid}/pages

    Get the page and section plan — Returns structure, pages with their sections and edited flag, one-page sections and the sections available to add. Same payload as the dashboard.

  • POST /sites/{uuid}/pages

    Save the page and section plan — Body: pages (list of {slug, title, nav, sections}; the first page is index) and, for onepage sites, onepage_sections. Sections of pages with saved edits are locked in the dashboard; edited pages that are removed lose their edits. At most 12 pages.

  • GET /sites/{uuid}/style

    Get style overrides — Returns stored overrides, effective colors, fonts, radius and density, and the allowed font, radius and density values.

  • POST /sites/{uuid}/style

    Save or reset style overrides — Send style ({colors, fonts: {heading, body}, radius, density}) or reset=true to return to the theme.

  • GET /sites/{uuid}/design

    Get site title, theme and layout — Returns site_title, title_suggestions, theme_variant, theme_mode, layout, structure and whether the site has saved edits.

  • POST /sites/{uuid}/design

    Change site title, theme, mode, layout or structure — theme_variant, theme_mode, layout and structure are required; site_title (1-200 characters), apply_blueprint and reset_edits are optional. Changing theme, layout or structure while pages have saved edits returns 409 edits_reset_required unless reset_edits is true; renaming alone keeps edits.

  • GET /sites/{uuid}/tracking

    Get tracking settings

  • POST /sites/{uuid}/tracking

    Save tracking settings — Body: tracking {ga4_measurement_id, google_ads_id, google_ads_conversion_label, meta_pixel_id, privacy_policy_url, terms_url}. Applied to exports; an empty object removes all tracking.

  • GET /sites/{uuid}/media

    List uploaded site images

  • POST /sites/{uuid}/media

    Upload or delete site images — multipart/form-data with one or more files in files[] (PNG, JPEG, WEBP or GIF, 5 MB each, at most 200 images per site), or JSON {"action": "delete", "name": <name>}. Returns the updated list for uploads. 409 conflict when the per-site image limit is reached.

Pagos externos (solo claves de administrador)

  • GET /payment-sites

    List external payment sites owned by the admin API account — Admin role required; payment.manage permission alone is insufficient. Webhook secrets are never returned.

  • POST /payment-sites

    Register an external payment site (admin only)

  • PATCH /payment-sites/{id}

    Update an owned external payment site (admin only)

  • DELETE /payment-sites/{id}

    Delete an owned external payment site (admin only) — Deletion is allowed only when the site has no orders. Sites with orders must be disabled instead.

  • GET /payments

    List external orders owned by the admin API account

  • POST /payments

    Create external checkout or automatic subscription (admin only) — Server-to-server only. Separate from wallet top-ups: no White Page Kit balance, bonus or referral credit. Repeated idempotency key returns the original order; a different payload or reused external order ID conflicts. Provider uncertainty never starts a second checkout automatically.

  • GET /payments/{uuid}

    Read owned external payment status (admin only)

  • POST /payments/{uuid}/cancel

    Cancel an owned subscription or locally close a pending one-time order (admin only) — Subscriptions stop future renewals. Pending one-time cancellation is a local close, not a refund; an already-open provider checkout may still accept payment. A late authenticated real payment remains recorded and notified. No payment is marked paid by a browser return.

  • POST /payments/{uuid}/approve

    Approve funds received for an owned pending or locally cancelled bank transfer (admin only) — Manual confirmation of funds received, including a transfer arriving after local cancellation; never approves a Dodo or Enigmoss order and never credits White Page Kit balance.

Las descripciones provienen del documento OpenAPI y están en inglés. Los esquemas de solicitud y respuesta están en el archivo schema.

Integraciones listas para usar

El kit de integración es una pequeña aplicación PHP con un formulario generador, encuestas de estado, guía de callback firmado y un editor visual completo que se comunica con esta API a través de un proxy del lado del servidor. Crea una cuenta para obtener una clave, luego consulta precios para saber el costo de cada generación.