开发者接入指南：入驻成为伙伴、创建应用、在沙箱自测并提交认证

受邀开发者伙伴的操作指南：接受邀请、创建应用和版本、在专属沙箱里自测、提交认证、按审核意见修改重提，以及管理成员和账号资料。

第一步：接受邀请#

开发者通道采用邀请制。平台团队邀请你后，你会收到一封带接受链接的邮件（链接 7 天内有效）。打开链接，用受邀的那个邮箱地址登录并确认，你的开发者账号即激活，并进入开发者中心。如果用其他邮箱登录，接受会被拒绝、邀请不会被消耗——请退出后用受邀邮箱重新登录。如果链接已过期，请让平台团队补发一封。

第二步：创建应用和第一个版本#

在开发者中心点「新建应用」，填应用编码和显示名。然后打开应用新增版本：填版本号，并声明这个版本需要什么——申请的数据权限（scope）、允许嵌入的网页来源、页面在租户菜单里的出现位置，以及它带来的现成内容包。声明只能在版本处于草稿或被退回修改时编辑；之后即锁定，任何变更都要发新版本。你只能看到自家开发者账号名下的应用——别家伙伴的应用看不到、也打不开。

第三步：先在沙箱里自测#

打开「沙箱」页开通沙箱——每个开发者账号有一个专属测试组织，与真实租户完全隔离。在沙箱里，即使应用还没通过认证，你也可以安装自家应用、签发沙箱凭证，并用凭证调用公开 API，把对接端到端验一遍。提交前请在沙箱页跑一次自测：它跑的正是认证关口会跑的同一套自动检查（连通、跨组织拒绝、事件签名校验），结果会留痕，问题可以提前修。重置沙箱会清空沙箱内的全部内容重新开始，自测历史会保留。沙箱凭证只在你的沙箱内有效，永远碰不到任何真实租户的数据。

第四步：提交认证#

打开版本点「提交」。先跑自动检查——要让它跑起来，你的应用必须已经装进你的沙箱并建好事件订阅，与自测时的准备相同。如果自动检查还跑不起来，提交会被挡下并提示缺什么；不会有任何静默放行。自动部分通过后，平台审核团队会逐项处理清单里余下的人工项。进度随时可以在版本页查看：每一项都显示结果，被退回的项会以明白的话写明审核原因（你不会看到审核的内部细节）。

第五步：版本被退回时#

版本被退回（「要求修改」）不是应用被拒，而是具体项需要整改。逐项读审核原因，修好你的对接；如果声明需要改，可以直接改（被退回的版本会重新可编辑）。再跑一次沙箱自测，然后在同一个版本页重新提交。全部项通过后，版本获得 12 个月认证。认证通过后，发布由你自己在同一个版本页完成：只想发给指定租户时，在版本的名单（allowlist）栏填入组织名单并保存——只有名单内的组织能看到并安装这个版本，名单可随时更新；公开发布由平台团队开启。

成员与账号资料#

在「成员」页，账号所有者可以按邮箱邀请队友、直接添加已有用户、移除成员；受邀队友按第一步同样的方式接受。成员可以操作账号名下的应用，但成员管理只有所有者能做。在「账号资料」页可以查看开发者账号的详情；所有者可以改账号名称和联系邮箱——状态等平台管理的字段只读显示。如果你的开发者账号被平台团队停用，你的应用将不能被新安装或提交，直到恢复为止——遇到这种情况请联系平台团队；已安装的应用保持既有状态、由平台团队处置。

查看评分与反馈#

在开发者中心你的应用页面上，可以看到安装了你应用的组织给出的评分：真实平均分、评分数量和按星级的分布。这些是真实总数，仅你可见。公开目录要等一个应用至少有 3 份评分后才会显示分数；在此之前显示的是「评分还太少」。如果你的页面提示样本还不够，这就是目录暂不显示分数的原因。

组织在评分时还可以留一句简短的私密留言。你能看到留言内容和星级，但永远看不到是哪个组织发的——反馈是刻意匿名的。如果你认为某份评分来自虚假安装而不是真实客户，请通过平时的支持通道联系平台团队，说明是哪个应用、大约什么时候出现的评分；平台团队可以核查安装记录，并隐藏不该计数的评分。平台从不修改星值——被隐藏的评分在核查通过后可以恢复。