健康检查
GET /health 是公开健康检查，返回服务名 gca-registration-api 和当前包版本。
中文 API 状态 / 2026-06-18
GCA 中文 API 状态
这一页用中文说明 GCA 邮箱注册和邮箱退订接口的当前状态。公网邮箱注册已经接到 Cloudflare Workers + D1，普通用户可以通过官网表单提交邮箱；管理员读取接口仍需要本地管理 token。
最新公网只读检查已在 2026-06-18T08:41:31Z 通过，检查范围包括健康接口、CORS、access config 和未授权管理员读取拦截，不写入测试注册记录。
最新部署权限检查在 2026-06-18T08:37:28Z 通过了 Worker dry-run 和 D1 可见性，但 cloudflare-auth-session 和 Worker 发布权限因为 Cloudflare error 10000 失败。解决这两个权限问题前，不能执行远端 migration 或 deploy。
这个 API 只处理邮箱注册和不再联系请求，不需要钱包、不需要签名、不需要付款，也不会激活 100 credits、GCA Member 或 10,000 GCA 会员权益。
API 基础地址
gca-registration-api.gcagochina.workers.dev
服务商
Cloudflare Workers + D1
公开检查
只读 / 不需要 secrets
最新检查
2026-06-18 通过
管理员读取
token 保护
当前已上线接口
邮箱注册
POST /gca/email-registrations 接收 gca_email_registration_v1。它只登记邮箱、展示名、来源、语言和兴趣标签。
邮箱退订
POST /gca/contact-suppressions 接收 gca_contact_suppression_v1，用于把邮箱加入 GCA 不再联系名单。
访问配置
GET /gca/access-config 公开返回 Base chainId 8453、GCA 合约、10,000 / 1,000,000 GCA 门槛和安全边界。
钱包余额验证
POST /gca/wallet-verifications 使用后端只读 eth_call 验证 GCA 余额，不需要签名、授权或交易。
会员账户提交
POST /gca/member-access 接收邮箱和 Base 钱包，写入钱包验证记录、100 credits 记录和 GCA Member 审核记录。
注册记录读取
GET /gca/email-registrations 是管理员读取接口。没有 token 的公网访问应返回授权错误，而不是用户记录。
退订记录读取
GET /gca/contact-suppressions 也是管理员读取接口，只给本地运营同步使用。
账本读取
GET /gca/credit-ledger 和 GET /gca/member-ledger 都是管理员 token 保护接口，公网不能直接读用户账本。
服务请求队列
GET/POST /gca/service-requests 已完成源码、D1 迁移和 Worker dry-run。2026-06-18 检查显示 D1 可见性已通过；正式发布仍被 cloudflare-auth-session 和 Worker 发布权限的 Cloudflare error 10000 阻塞，远端 D1 migration、wrangler deploy 和待发布接口 smoke 检查仍不能执行。
Credit 使用记录
GET/POST /gca/credit-usage 已完成源码、D1 迁移和 Worker dry-run。2026-06-18 检查显示 D1 可见性已通过；正式发布仍被 Cloudflare 账号认证和 Worker 发布权限的 Cloudflare error 10000 阻塞，远端 D1 migration、wrangler deploy 和待发布接口 smoke 检查仍不能执行。
未来域名
api.gcagochina.com 仍等待 Cloudflare DNS 区域权限；当前正式入口先使用 workers.dev 地址。
公开只读检查
这个命令检查公网 API 健康状态、CORS 和未授权读取是否被拦截。它不写入注册记录，不需要管理员 token。
python3 tools/check_gca_registration_api.py --public-only --timeout 30
本地管理员检查
这个命令只适合运营者在本地执行，用本地 token 读取少量样本，确认管理员读取接口可用。不要把 token 文件公开。
python3 tools/check_gca_registration_api.py --token-file cloudflare/gca-registration-worker/.env.admin.local --limit 5
部署权限检查
发布新的 Worker 版本前先运行这个命令，确认打包、Cloudflare 账号认证、D1 可见性和 Workers 发布权限。最新结果是 dry-run 通过、D1 可见性通过、cloudflare-auth-session 失败、Worker 发布权限失败并返回 error 10000。如果报告出现 authRecovery.status，先按 authRecovery.safeNextActions 处理，不能直接迁移或部署。
python3 tools/check_gca_worker_deploy_readiness.py --run-wrangler --run-cloudflare --require-deploy-auth
待发布接口验收
/gca/service-requests 和 /gca/credit-usage 不能只因为 dry-run 通过就说已上线。D1 可见性已经在 2026-06-18 检查中通过，但 Cloudflare 账号认证和 Worker 发布权限仍失败；必须先解决 error 10000，再完成远端 D1 migration、wrangler deploy、公开 smoke check 和管理员 smoke check，并且两个 smoke check 都要带 --include-pending-routes。
python3 tools/check_gca_registration_api.py --public-only --timeout 30 --include-pending-routes
python3 tools/check_gca_registration_api.py --token-file cloudflare/gca-registration-worker/.env.admin.local --limit 5 --include-pending-routes
普通用户应该知道
- 邮箱注册不需要钱包地址，不读取钱包余额。
- 邮箱注册不需要私钥、助记词、钱包签名、验证码、付款或交易所 API Secret。
- 会员账户入口可以写入符合条件的 100 credits / GCA Member 账本记录，但 10,000 GCA 会员权益仍需人工审核。
- 邮箱退订只影响后续联系导出，不改变 GCA 持仓、池子、链上资产或会员处理状态。
运营者使用路径
导出注册记录tools/export_cloudflare_email_registrations.py
同步本地账本tools/sync_cloudflare_email_registrations.py
导出联系 CSVtools/export_gca_email_contacts.py
同步退订记录tools/sync_cloudflare_contact_suppressions.py
运营汇总tools/run_gca_registration_ops.py
中文流程说明zh-operations.html
中文 API 状态引用
普通用户可以使用当前中文页面、运营流程、隐私说明和参与条款确认 GCA 邮箱注册、会员账户提交和只读钱包验证边界。