Kasada Pure API

线上接入信息

项	值
Base URL	https://kasada-pure-api.pages.dev
API Key	6ecadef6f243b68260ecdf3b967762ff
鉴权 Header	X-API-Key: 6ecadef6f243b68260ecdf3b967762ff
备用	Authorization: Bearer 6ecadef6f243b68260ecdf3b967762ff
健康检查	GET /api/health（免 Key）

接口列表

方法	URL	Key
GET	/api/health	否
POST	/api/mint	是
POST	/api/parse	是
GET	/api/bootstrap	是

POST /api/mint

产出完整 Kasada 头。默认 engine=fast（官方 WASM，~200ms）；纯算用 engine=pure（CPU 重，CF 免费档可能 503）。

字段	类型	说明
engine	string	fast（默认）| pure
bootstrap	string	可选。站点 /larkbileomet.js?async 源码；不传则服务端代拉
site	string	可选。默认 pokemoncenter-online
sensorRounds	number	可选。默认 8（越大 a 越长，越慢）
encodeRounds	number	可选。默认 3
fetchBootstrap	bool	可选。默认 true

curl（可复制）

export BASE="https://kasada-pure-api.pages.dev"
export API_KEY="6ecadef6f243b68260ecdf3b967762ff"

curl -sS -X POST "$BASE/api/mint" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{"engine":"fast","sensorRounds":8,"encodeRounds":3}'

响应

{
  "ok": true,
  "engine": "official_wasm",
  "pure_algorithm": false,
  "official_wasm": true,
  "a_len": 4247,
  "b": "-78y18c",
  "headers": {
    "KsL6nWTYBY-a": "...",
    "KsL6nWTYBY-b": "...",
    "KsL6nWTYBY-c": "...",
    "KsL6nWTYBY-d": "...",
    "KsL6nWTYBY-f": "...",
    "KsL6nWTYBY-z": "q"
  },
  "static": { "c": "...", "z": "q", "f": "...", "a0": "..." },
  "ms": 210
}

Python

import requests

BASE = "https://kasada-pure-api.pages.dev"
API_KEY = "6ecadef6f243b68260ecdf3b967762ff"

r = requests.post(
    f"{BASE}/api/mint",
    headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
    json={"engine": "fast", "sensorRounds": 8, "encodeRounds": 3},
    timeout=120,
)
data = r.json()
headers = data["headers"]  # 并进业务请求

POST /api/parse

只解析 bootstrap 静态字段（纯协议，毫秒级）。

curl -sS -X POST "https://kasada-pure-api.pages.dev/api/parse" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: 6ecadef6f243b68260ecdf3b967762ff" \
  -d '{}'

GET /api/bootstrap

代拉当前站点 bootstrap 源码。

curl -sS "https://kasada-pure-api.pages.dev/api/bootstrap" \
  -H "X-API-Key: 6ecadef6f243b68260ecdf3b967762ff"

对接注意

• 所有业务接口（除 health）必须带 X-API-Key: 6ecadef6f243b68260ecdf3b967762ff，否则 401。
• 过网关还需要业务 cookie（本站：gmid/ucid 等 Gigya），与 a/b 算法无关。
• 线上请用 engine=fast；engine=pure 在 CF 免费档可能 503。
• 网关验收：HTTP 200 + 业务错误（如 Invalid CaptchaType），不是 403 空体。