先定心：这个后台你只会来一次。
它的唯一用途是"办一把钥匙"——拿到
Client ID 和 Client Secret。
办完就可以关掉，以后看数据都在中文看板里，不用再回来。
1你现在只需要做 4 件事
- 在 New App 页填 NAME（应用名，会显示在授权页上）、LOGO（可跳过）、CONTACTS（你的邮箱）
- 往下滚，勾 Scopes（权限）——至少勾
offline，其余全勾 - 填 Redirect URIs（回调地址）
- 点 Create → 复制出现的 Client ID 和 Client Secret
2每个英文词的准确意思
| 后台上的英文 | 中文 | 它到底指什么 |
|---|---|---|
| App | 应用 | 你要登记的一个"程序身份"。你只是自己用，也必须有这么一个身份，否则 WHOOP 不认 |
| Team | 团队 | 第一次登录会要求建，名字随便填，只是分组用 |
| Client ID | 应用编号 | 相当于用户名，可以公开 |
| Client Secret | 应用密钥 | 相当于密码，不能外传，只填进你电脑上那个页面 |
| Scopes | 权限范围 | 这个应用能读你哪些数据。勾得越少，能显示的卡片越少 |
| Redirect URI(s) | 回调地址 | 授权完成后"跳回哪里"。必须和看板里显示的那串一模一样，差一个字符就失败 |
| Sandbox / Tier | 档位 | 新应用默认 Sandbox，最多 10 个会员连接。自己用完全够，不用审核 |
| Open Request | 提交请求 | 要提升人数上限或调用频率时才用。你自己用永远不用点 |
| Rate limit | 调用限额 | 默认每分钟 100 次、每天 10000 次，正常看数据碰不到 |
3表单里每个框填什么
下面按实际界面（New App 页）从上到下排列。没看到的字段说明还没滚到，继续往下拉。
| 输入框 | 填什么 | 填错会怎样 |
|---|---|---|
| NAME App name displayed to the user in the OAuth flow |
填 WHOOP 中文看板 或 my-whoop-cn。这一串会显示在授权页上，让点"同意"的人看到是谁在要数据 |
不影响功能，但名字太随意，对方不知道授权给了什么 |
| LOGO .jpg 或 .png，1:1 |
可以上传我们生成好的图标：whoop-cn\public\icons\icon-512.png（正方形 PNG） |
格式不对或不是 1:1 会传不上去；不传一般也能过 |
| CONTACTS Contact emails for this app |
填一个邮箱（可以多个，用逗号分隔） | 收不到 WHOOP 的通知；你自己用影响不大 |
| Scopes（通常在下面） | 全勾，尤其 offline |
少勾 offline：一小时就要重新登录；少勾 read:sleep：睡眠卡空白且不报错 |
| PRIVACY POLICY Link to your privacy policy |
填一个隐私政策网页的链接，不是回调地址！ 本机现成的一页： http://localhost:5180/privacy.html或者填 https://www.whoop.com/privacy/ |
填成回调地址会链接到一个空页面；这一栏显示给授权的人看 |
| REDIRECT URLS Location to which the user is taken after logging in |
点 ADD 新增一条，填：http://localhost:5180/auth/callback（从 填写页 复制） |
回调地址填错 → 授权后跳不回来，或提示 redirect_uri 不匹配 |
⚠️ 这两个框最容易放反：PRIVACY POLICY 要的是"隐私政策网页"，REDIRECT URLS 才是"回调地址"。
后台明说回调只接受
https:// 或 whoop:// 开头，http://localhost
可能被拒——先照填试一下；如果被拒，回来找我用域名（隧道）方案，我把地址改好给你。
4页面上的英文按钮
| 按钮 | 作用 | 要不要点 |
|---|---|---|
| Create App | 新建应用 | ✅ 要点 |
| Create / Save | 保存 | ✅ 填完要点 |
| Edit（铅笔图标） | 修改应用 | ⚠️ 填错了才点 |
| Open Request | 申请提额 | ❌ 用不到 |
| Delete（红色垃圾桶） | 删除应用 | 🚫 千万别点，删了不可恢复，密钥立刻作废 |
| Show / Reveal（小眼睛） | 显示被遮住的密钥 | ✅ 复制 Secret 时要点 |
5建完之后
页面上会出现两串字符：
Client ID ＜一串编号＞
Client Secret ＜一串更长的密钥＞把这两个值粘到 填写凭据页，点保存 → 回看板点「用 WHOOP 账号登录」，让账号本人点同意即可。
🔒 Client Secret 等于密码。别发到群里、别截图发朋友圈；填进本机页面后它就只存在你电脑的
config.json 里。
🤔卡住时对照
| 你看到 | 意思 / 怎么办 |
|---|---|
Redirect URI is invalid | 回调地址格式不对。用填写页上的「复制」按钮，别手打 |
Required field | 有必填没填，通常是 Privacy Policy URL 或 Contact Email |
At least one scope is required | 一个权限都没勾，至少勾 offline |
登录后被要求 Create Team | 正常，第一次都要建，名字随便写 |
| 找不到 Scopes 在哪 | 在 Create App 的表单里，往下滚动；有些布局是勾选框列表 |
官方原文：Getting Started · App Approval（讲档位的那页）