切换主题
环境与兼容
当前手册适用于受邀开发者使用的 Test 环境。本地契约准备版本为 40.62.0，SDK 迁移尚在验收；实际部署和文档构建版本见构建信息，不以本地版本号判断接口已经开放。
环境使用
| 入口 | 地址 | 用途 |
|---|---|---|
| 开发者中心 | https://console.developers.metaeco.top/ | 应用、配置、成员和版本管理 |
| Test API | https://miniapp-api.metaeco.top | 应用后端调用；以本应用确认的入口为准 |
| 开发者文档 | https://developers.metaeco.top/ | 阅读手册及下载公开契约 |
示例中的 PLATFORM_ORIGIN 填写实际 API 入口。导入 OpenAPI 后替换 platformOrigin 的示例值。凭据和数据按环境隔离；当前没有可用于生产接入的公开 Production 入口。
当前接入范围
| 范围 | 当前使用方式 |
|---|---|
| 注册与版本管理 | 在开发者中心完成入驻、成员、配置、体验、审核和发布 |
| 应用后端 API | 公开参考包含 12 个接口，按各自应用状态和鉴权条件调用 |
| 登录 | 宿主获取 code，业务后端兑换 openid 和 session_key；无跨应用 UnionID |
| 手机号 | 非个人主体资格、普通接口白名单、隐私与用户确认；详见手机号 |
| 余额支付 | MetaEco 原生余额支付，商户绑定、Bearer token 和请求签名；详见支付 |
| 指定用户灰度与回滚 | 通过发布管理使用；全局比例、组织和设备灰度不在当前开放范围 |
| 包格式 | Frozen Package Format v1 .cmpkg，工具构建后上传 |
小程序码、URL Link、订阅消息发送、发货及确认收货提醒不在当前公开 API 范围。微信支付协议的受邀 SDK 迁移正在验证，配置和当前限制见标准 SDK 接入。自动生成的 API 目录仍为上表所述 12 个接口，不包含这组正在验收的支付协议。宿主中存在某个方法不等于服务端发送接口已开放。
受邀联调：未发布应用生成小程序码
已为本应用开放二维码联调的团队，可使用标准 SDK 调用 /wxa/getwxacodeunlimit。应用为 draft 时仍须使用有效 AppID、AppSecret 获取的接口 token；token 过期、撤销、凭据失效或应用停用时拒绝生成。
未发布页面须显式设置 check_path=false，开发版设置 env_version=develop。缺省参数仍是 check_path=true、env_version=release，不会自动选取最近的调试会话或切换版本。开启路径检查而没有已发布版本/页面时返回 41030，生成成功返回 PNG，失败返回 JSON。此行为依据微信获取不限制的小程序码（2026-10-14 核验）。
生成码不授予扫码用户开发版或体验版资格，也不发布应用。实际扫码、宿主唤起和海报合成仍须按所用宿主与构建工具分别验收；业务后端不需要传入平台内部调试会话字段。本项不放开 draft 应用的 URL Link 或订阅消息接口。
工具与 SDK 分发
| 材料 | 当前获取方式与限制 |
|---|---|
| 构建工具 | 受邀团队提供源码或安装版本，源码包为 community-miniapp-tool 0.1.0；本站暂无公开下载地址 |
| 桌面安装包 | 现有 Mac ARM64 材料需核对版本与源码摘要；已有 .app 与当前提供源码不同，DMG 内容未确认；Windows/Linux 安装制品未提供 |
| 小程序 JS 运行时 | 工具随包生成；无需另行安装 SDK，支持范围见方法差异 |
| Android/iOS 宿主 | 使用团队提供的 APK 或 iOS 签名联调版本；需要对应版本号、摘要和最低系统要求 |
| 独立原生 SDK | 尚无完整公开 AAR/Maven、Pod/XCFramework 或 npm 分发，以及初始化、生命周期和线程约束契约；当前按现有宿主接入 |
开始设备联调前，需要取得与包匹配的安装版本和系统要求；缺少这些材料时可先完成源码、后端与构建准备。
双端 SDK 接入
JS 入口、参数、回调、Android/iOS 差异和设备测试步骤见运行时与双端 SDK。
当前方法差异
wx.checkSession、wx.getSetting 和 wx.authorize 尚未导出；wx.openSetting、wx.canIUse 和元素查询包含占位行为；wx.chooseAddress 两端不支持。扫码、保存到相册和下载文件等虽有 JS 入口，当前提供的宿主仍返回 unsupported。使用相关方法前查看具体处理方式。
微信行为与平台差异
- 登录采用
wx.login→ 自有业务后端 →/sns/jscode2session，AppID 和 AppSecret 使用 MetaEco 配置。 - 微信兼容 token 与手机号采用
/cgi-bin/token、/wxa/business/getuserphonenumber；平台原生会话、诊断和余额支付使用各自 Bearer 契约。 - MetaEco 定位准入与整份隐私指引审核合并；平台入驻核验、隐私审核和余额支付分别使用 MetaEco 规则。
- 当前授权记录覆盖
scope.userLocation与scope.writePhotosAlbum；业务代码不传宿主内部运行字段。 - 本地预览用于页面检查；当前不提供完整的包上传前真实登录调试链路，真实登录使用宿主体验版。
- 用户删除后重新添加应用的授权行为依赖对应宿主版本，升级前需确认所用版本支持该流程。
应用支付请求公钥与签名
公钥登记、请求签名、轮换和失败处理见余额支付签名。
MetaEco 余额支付事件通知
通知字段、验签原文、事件去重和查询确认见余额支付通知。