企业官网建设流程全解析

1. 轮盘抽奖代码联调时，Key 到底该放哪

轮盘抽奖代码本身不复杂，前端一个 canvas 或 CSS transform 转盘，后端一个/api/lottery/draw接口返回中奖结果。真正让人头疼的是联调阶段：前端本地跑一个服务、后端本地跑一个服务、再加一个 Postman 或 curl 做接口验证，三四个工具各自维护一份 API Key 和 Base URL。改一次地址要改三处，谁写错了就报 401，排查半天发现是某个配置文件里还留着旧 Key。

这篇就聚焦这个场景：轮盘抽奖代码 + 抽奖接口联调，用 TaoToken 统一 Key 和 API 通道，把settings.json和config.toml两份配置写成可复制的骨架，再演示一次抽奖请求从发起到拿到结果的完整验证动作。适合正在写抽奖活动页、需要频繁切换本地/测试环境、或者团队里多人共用一套接口配置的开发者。读完你能直接抄配置、跑通一次抽奖请求，并且知道 401、404、超时这几类报错分别该查哪里。

TaoToken 在这里扮演的角色是统一的 API 通道：你只需要在它那边生成一个 Key，前端、后端、命令行工具都指向同一个 Base URL，抽奖接口的鉴权头由它统一转发。这样轮盘抽奖代码里不用硬编码任何密钥，配置文件里也只出现一个 Key 变量。

2. TaoToken 前置准备：拿到统一 Key 和通道地址

在写配置之前，先把两样东西准备好：一个 API Key，一个 Base URL。这两样东西后面会同时出现在settings.json和config.toml里，所以先确认清楚。

打开 TaoToken 控制台，进入 API Keys 页面创建一个新 Key。建议按用途命名，比如lottery-dev，这样后面如果抽奖服务和别的服务共用账号，你能一眼分清哪个 Key 是给抽奖联调用的。创建完成后把 Key 复制出来，它通常是一串以固定前缀开头的字符串，只显示一次，丢了就得重建。

通道地址统一用https://taotoken.net/api，注意这里不带任何查询参数，路径拼接由你的抽奖接口自己决定。比如你的抽奖接口是/lottery/draw，那完整请求地址就是https://taotoken.net/api/lottery/draw。这个拼接规则很重要，后面排查 404 的时候第一件事就是看路径有没有拼错。

如果你还没创建过 Key，可以直接去控制台的 API Keys 页面操作；想先看看模型对话效果，也可以从模型对话入口进去试一次请求，确认 Key 是通的。这两个入口分别是：

• API Keys 管理：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
• 模型对话体验：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite

注意：Key 不要写进前端源码里提交到仓库。前端联调阶段可以用环境变量注入，生产环境必须走后端转发。这篇演示的settings.json是给本地工具链用的，不是给浏览器直接读的。

3. 可复制配置：settings.json 与 config.toml 骨架

轮盘抽奖代码联调通常涉及两类工具：一类是 Node 生态的脚本或编辑器插件，读settings.json；另一类是 Python 或 Rust 写的后端服务，读config.toml。两份配置里都只保留一个 Key 字段和一个 Base URL 字段，其余全部走默认值，这样改环境时只动一处。

3.1 settings.json 骨架

{ "lottery": { "apiBase": "https://taotoken.net/api", "apiKey": "${TAOTOKEN_API_KEY}", "drawPath": "/lottery/draw", "timeoutMs": 8000, "retry": 1 }, "tools": { "defaultProvider": "taotoken", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKeyEnv": "TAOTOKEN_API_KEY" } } } }

这里apiKey用的是${TAOTOKEN_API_KEY}占位符，实际运行时从环境变量读取。这样同一份settings.json可以在不同机器上复用，只要各自设置好自己的环境变量。drawPath单独抽出来，是为了后面改接口路径时不用翻遍整个文件。

3.2 config.toml 骨架

[lottery] api_base = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}" draw_path = "/lottery/draw" timeout_ms = 8000 retry = 1 [provider.taotoken] base_url = "https://taotoken.net/api" api_key_env = "TAOTOKEN_API_KEY"

两份配置的字段名不同，但结构一一对应。api_base和apiBase是同一个东西，api_key_env和apiKeyEnv也是。这样设计的好处是，无论你的抽奖服务用哪种语言写，配置的语义是一致的，团队里换人维护时不用重新理解一遍。

设置环境变量的命令，Linux/macOS 下：

export TAOTOKEN_API_KEY="你的Key"

Windows PowerShell 下：

$env:TAOTOKEN_API_KEY="你的Key"

设置完可以用echo $TAOTOKEN_API_KEY或echo $env:TAOTOKEN_API_KEY确认一下有没有生效。这一步经常被跳过，结果配置文件读不到变量，报的错却是 401，方向就找偏了。

4. 验证一次抽奖请求：从发起到拿到结果

配置写好了，接下来跑一次真实的抽奖请求，确认整条链路是通的。分两步：先用 curl 验证接口本身，再在前端轮盘抽奖代码里接上。

4.1 用 curl 验证抽奖接口

curl -X POST "https://taotoken.net/api/lottery/draw" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"test_001","activityId":"wheel_2024"}'

正常返回应该是一个 JSON，包含中奖结果字段，类似：

{ "code": 0, "data": { "prizeId": "p_03", "prizeName": "免单10", "angle": 135 } }

angle字段就是给前端转盘用的旋转角度。你的轮盘抽奖代码拿到这个角度后，用 CSS transform 或 canvas 旋转到对应位置即可。注意角度值要和转盘上奖品的分布对齐，否则会出现「显示免单10、实际发的是免单5」这种对不上的问题。

4.2 前端轮盘抽奖代码接上接口

前端部分只保留请求逻辑，转盘动画用你原来的实现即可。核心是这一段：

async function drawLottery(userId, activityId) { const res = await fetch("https://taotoken.net/api/lottery/draw", { method: "POST", headers: { "Authorization": `Bearer ${window.__TAOTOKEN_KEY__}`, "Content-Type": "application/json" }, body: JSON.stringify({ userId, activityId }) }); if (!res.ok) { throw new Error(`draw failed: ${res.status}`); } const json = await res.json(); return json.data; }

拿到data.angle之后，调用你原来的startMove(angle, prizeName)函数，转盘就会转到对应位置并弹出中奖提示。这里window.__TAOTOKEN_KEY__只是本地联调时的临时注入方式，生产环境请改成后端代理，前端不直接持有 Key。

4.3 后端服务读取 config.toml 的示例

如果你的抽奖接口是后端自己实现的，读取配置的代码大概长这样：

import os import tomllib import httpx with open("config.toml", "rb") as f: cfg = tomllib.load(f) api_key = os.environ[cfg["lottery"]["api_key"].strip("${}")] base = cfg["lottery"]["api_base"] path = cfg["lottery"]["draw_path"] async def draw(user_id: str, activity_id: str): async with httpx.AsyncClient(timeout=8) as client: resp = await client.post( f"{base}{path}", headers={"Authorization": f"Bearer {api_key}"}, json={"userId": user_id, "activityId": activity_id}, ) resp.raise_for_status() return resp.json()["data"]

跑通这一步，说明配置读取、环境变量、请求头、路径拼接四个环节都没问题。接下来如果前端转盘动画不对，那就纯粹是前端角度计算的问题，和接口无关，排查范围一下就缩小了。

5. 本篇常见错排查

联调阶段报错集中在四类，按出现频率排一下。

401 Unauthorized：九成是 Key 没读到或者读错了。先确认环境变量有没有设置成功，再确认配置文件里读的是不是同一个变量名。还有一种情况是 Key 复制时带了空格或换行，Bearer后面多一个空格也会 401。用echo打印出来看一眼最直接。

404 Not Found：路径拼接错了。检查apiBase末尾有没有多余的斜杠，drawPath开头有没有斜杠。https://taotoken.net/api加/lottery/draw是对的，但如果apiBase写成https://taotoken.net/api/，拼出来就是双斜杠，部分服务会当成不同路径。统一约定：Base 不带尾斜杠，Path 带前斜杠。

超时 / timeout：timeoutMs设太短，或者抽奖接口本身响应慢。先单独用 curl 测一次接口耗时，如果 curl 很快但代码里超时，那就是代码里的超时配置没生效，检查一下是不是被上层框架的默认超时覆盖了。

转盘角度对不上：接口返回的angle和转盘奖品分布不匹配。这种情况接口是通的，问题在前端。把接口返回的prizeId和转盘上每个扇区的索引做一次映射，别直接用角度硬算，映射表更稳。

提示：排查顺序建议从 curl 开始，curl 通了再查代码，代码通了再查前端动画。不要一上来就同时改三个地方，那样即使修好了也不知道是哪个改动起的作用。

6. 后续接入与长期使用建议

轮盘抽奖代码联调跑通之后，如果你还要接更多接口，比如用户信息、奖品库存、发奖回调，建议继续沿用同一套配置结构：所有接口共用apiBase和apiKey，每个接口只加一个xxxPath字段。这样配置文件不会随着接口数量膨胀而变乱。

长期做编码和 Agent 类项目的，可以考虑 Coding Plan，把抽奖服务之外的开发工具也统一到同一个通道下，省得每个工具单独配一遍 Key：

• Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite
• 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

如果你用的是 Claude Code 这类工具做抽奖服务的后端开发，接入方式可以参考：

• Claude Code 接入：https://taotoken.net/claude-code?utm_source=taotoken_aicg_blog_end&utm_content=claude_code&utm_campaign=rewrite

最后留一个实际经验：配置文件里的 Key 永远用环境变量占位，不要图省事直接写死。我见过太多因为把 Key 提交到仓库、然后不得不全量轮换的案例，轮换一次要通知所有联调的人重新拉配置，成本远高于一开始就多写一行export。