开发者平台
让用户用 e 账户登录你的应用,并实时核验他们的内测资格。安装包始终由你的 GitHub 仓库分发。
创建应用需要认证
蓝 V、金 V 与灰 V 账户可以创建开发者应用。你仍可以先阅读下方的接入说明。
申请蓝 V 认证我的应用
接入说明
- 在应用中生成 PKCE:code_verifier 为 43~128 位随机串,code_challenge 为其 SHA-256 的 Base64URL。
- 打开授权页,用户确认后回到你的回调地址,携带 code 与 state。
- 用 code 与 code_verifier 换取访问令牌(1 小时)与刷新令牌(90 天,每次刷新轮换)。
- 调用资料接口读取用户名、头像与认证;调用内测接口查询用户对你发布的软件是否有内测资格。
令牌只能访问下列开放接口,不能读写用户的其他数据。用户可随时在“设置 → 已授权的应用”中撤销授权。
接入库
不想自己处理 PKCE 与令牌刷新,可以直接用官方接入库(无依赖,复制到你的项目里使用):e-login.js(浏览器与 Node 20+)、e-login-node.mjs(桌面与命令行,需与 e-login.js 放在同一目录)。
网页应用
桌面应用(Node / Electron)
内测资格检查
- 只能查询你自己在 e 上发布的软件(slug 或 ID)。返回 allowed 表示当前用户能不能使用内测版。
- mode 为 platform 时,平台内测用户都可以使用;为 allowlist 时,只有你在软件页添加的内测成员可以使用,expires_at 是成员资格的到期时间。
- 建议每次启动时检查一次(离线时可沿用最近一次结果,但不要超过一天)。用户撤销授权或资格被移除后,刷新令牌会失败或 allowed 变为 false。
- 刷新令牌返回 invalid_grant 时,说明授权已失效,请让用户重新登录。不要把令牌写进网址或日志;桌面应用把刷新令牌存进系统钥匙串。
订阅与自动发现
以下地址按当前域名生成,无需登录,换域名后自动跟随。条目 ID 使用内容 UUID,域名变化不会产生重复条目。
帖子、主页与软件页带有 Open Graph 标签,分享到聊天软件或社交平台时会显示预览卡片。