开发者注册与登录

创建开发者账号，或使用已有账号登录控制台。这是接入 SDK 的研发商、工作室或个人开发者账号，与游戏玩家账号分开。

当前正式环境

正式开发者接口位于 https://developer.starai.art，不能发到 api.starai.art。当前已开放开发者自助注册，须主动阅读并同意开发者服务协议与隐私政策；具体入口和能力见正式环境指南。账号开通后正常登录，不需要环境访问密码。

本次发布的开发者协议版本为 2026-09-12.1，运营方展示名称为“星途（STARLIGHT）平台运营方”（品牌描述，不是法人名称认证）。可阅读开发者服务协议与隐私政策。提交时仍以协议接口实时返回的版本和链接为准，不将此版本硬编码到注册客户端。开发者注册不依赖短信验证码；真实短信、收付款及代理合作服务仍未开放。

注册

仅在 registration-terms.available 为 true 的环境中注册。填写团队或个人开发者名称、登录账号、密码并确认密码。账号以字母开头，支持 3～40 位字母、数字、下划线或短横线；服务器统一转为小写。密码长度 10～128 位，必须包含字母和数字。注册界面从服务器加载当前服务说明，需阅读并同意后提交。

成功后自动进入专属工作台，可创建应用；新游戏保持 pending 待审，游戏和新增客户端平台仍需审核开通。注册不会自动获得其他团队的游戏、管理员权限或商户收款能力。

登录与恢复

当前开发者会话有效期 8 小时，当前浏览器标签页内刷新可恢复；恢复时仍由服务器核验身份。退出会清除本地候选，过期或账号停用后需重新登录。网络故障保留候选并允许重试。关闭标签页后的长期免登录不是当前行为。

本地登录页可展开查看演示账号；正式域名不展示或自动预填演示凭据。密码显隐仅改变输入显示，不参与存储。

注册接口

方法 / 路径	输入 / 输出
GET /api/developer/registration-terms	无需登录，返回 version、title、content、available、reason；可用正式配置另含 operatorName、termsUrl、privacyUrl
POST /api/developer/register	username、name、password、acceptedTerms: true、termsVersion；成功 201 返回 token 和 developer
POST /api/developer/login	username、password；成功返回 token 和 developer
GET /api/developer/me	开发者 Bearer，返回 developer

正式协议由已发布的 HTTPS 链接提供；content 可以为空，不应据此判断条款缺失。必须使用本次 GET 返回的 version，不要硬编码 2026-09。available: false 时显示 reason 并禁用提交；强行提交返回 503 REGISTRATION_UNAVAILABLE。

同一账号并发注册仅有一个成功；重复返回 USERNAME_EXISTS。条款版本不符返回 TERMS_VERSION_MISMATCH，重新加载条款并再次同意。注册限额为每 IP 15 分钟 5 次提交，失败提交也计入；限流返回 RATE_LIMITED 和 Retry-After。不要通过循环注册来处理网络错误；先尝试使用刚注册的账号登录。

账号维护

在“账号安全”修改密码。忘记密码时，由平台管理员核验身份后重置；当前未接邮件或真实短信找回，不展示不能工作的发送验证码按钮。管理员重置会撤销开发者会话。

服务与隐私请求

已登录开发者可提交资料访问、更正、删除或服务支持请求，并查看自己的处理状态和平台回复。不要提交密码、验证码、完整令牌、私钥或应用密钥。删除请求是人工核验与处理流程，提交或标记已处理均不会自动注销账号、删除游戏或改变资产。

以下接口位于 https://developer.starai.art，使用开发者 Bearer 会话；不能使用玩家或管理员令牌。

方法 / 路径	输入 / 输出
GET /api/developer/requests	可选 status=open/resolved、limit=1～100（默认20）、before；返回 items、total、nextCursor，仅限本人记录
POST /api/developer/requests	type=access/correction/deletion/support、content（1～2000字）、requestId；首次成功201，幂等或相同待处理请求返回200，结果为 request、replayed

记录含 id、developerId、type、content、status、response、version、createdAt、updatedAt、resolvedAt。翻页使用 nextCursor；在改变筛选条件后重新从第一页读取。每名开发者最多20条未处理请求，每15分钟最多30次提交；失败提交及冲突重试也计入限额。相同动作重试保存同一个 requestId，改变请求类型或内容时使用新标识。收到429时等待 Retry-After，不循环重发。平台回复与状态更新见运营处理流程。

会话异常与退出

刷新后先验证已保存身份。开发者账号被停用时返回登录页并显示原因；密码错误、普通业务权限错误或暂时断网不会冒充账号失效。退出立即清除本地身份，服务器撤销独立尝试。

浏览器存储不可用时当前页仍可登录和注册，控制台提示使用临时会话；刷新后可能需要重新登录。过期请求及迟到登录结果不能覆盖新账号。