API 接入手册
打开 API 用户中心：注册、登录、获取 API Key
API 调用手册
服务地址：https://ai.zhangwan.net · 下载 OpenAPI 文档
普通 API Key 只需请求头 Authorization: Bearer YOUR_API_KEY。不需要设备码或签名。网站应通过后端调用，Key 不能暴露给访客。
GET /api/members/me
Authorization: Bearer YOUR_API_KEY
先核对身份及当前权限，再读取任务资料。业务权限不足返回403，请管理员授权，不重复注册或改用他人凭证。
网站访客 → 你的网站后端（PHP / Node.js / Python）→ 掌玩 API
领取资料 → 在调用方执行 → 回传结果
PHP 示例（普通 API Key）
$ch = curl_init('https://ai.zhangwan.net/api/members/me');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AI_API_KEY')]
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($body === false || $status !== 200) throw new RuntimeException('HTTP '.$status);
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
echo $data['user']['username'];
curl_close($ch);Node.js 示例（普通 API Key）
const r = await fetch('https://ai.zhangwan.net/api/members/me', {
headers: { Authorization: `Bearer ${process.env.AI_API_KEY}` },
redirect: 'error', signal: AbortSignal.timeout(30000)
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
const data = await r.json();
console.log(data.user.username);Python 示例（普通 API Key）
import os, json, urllib.request
class NoRedirect(urllib.request.HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
req = urllib.request.Request('https://ai.zhangwan.net/api/members/me',
headers={'Authorization': 'Bearer ' + os.environ['AI_API_KEY']})
with urllib.request.build_opener(NoRedirect).open(req, timeout=30) as r:
data = json.load(r)
print(data['user']['username'])接口与回传规则
任务中心：GET /api/keyword-center/keywords；标题库：GET /api/title-library；风格：GET /api/styles；专题分页：GET /api/mining/browse?view=topics&limit=20；官网监控：GET /api/official-monitor/protocol。其余读取入口、各模块领取/回传协议见OpenAPI。
Bearer JSON写请求只需Content-Type: application/json，不再要求模块专用请求头。Cookie账号管理仍由页面处理CSRF。revision、claim、runId和eventKey等业务字段以模块协议为准。结果未知时先查询，不盲目重发外站。API Key无后台HTML、会员管理或密钥管理权限。
401凭证失效；403权限不足或加强模式签名失败；409版本/状态/幂等冲突；429降低调用频率；5xx先核实写入结果。默认每Key每分钟300次、每账号合计3000次（以用户中心显示为准），429读取Retry-After，模块自身限额继续有效。
普通 Key 被复制后也能使用，直至撤销；需要防止只复制Key时，选择设备签名模式。设备私钥也被复制仍可能被冒用。原有绑定凭证不会自动降级。