使用沙箱与只读调试
本页内容
先在沙箱练习已支持的模拟操作,再用自己的生产凭据验证真实只读接口。沙箱和生产使用不同凭据、入口和签名环境,不能互换。
选择调试方式
| 方式 | 适合做什么 | 数据范围 |
|---|---|---|
| 沙箱 | 练习已经支持的请求结构、签名和模拟流程 | 模拟数据,不能证明真实上传、签名或付款已经成功 |
| 开发者中心只读调试 | 核对本人已授权资源的真实读取结果 | 受当前账号和 API 应用权限约束 |
| 生产接入 | 在明确授权和业务确认后执行实际操作 | 真实资源,写入可能产生费用或状态变化 |
前提条件
在开发者中心取得沙箱功能许可和独立 AKS 凭据。先下载沙箱接口定义,确认要练习的逻辑操作已支持。不要用生产 AKP 请求沙箱,也不要用 AKS 请求生产接口。
调用沙箱
沙箱 HTTP 入口为 /sandbox.php,查询参数 resource 填逻辑 API 路径。签名使用实际沙箱入口及查询参数,环境为 sandbox。
沙箱身份查询
GET /sandbox.php?resource=%2Fapi%2Fv1%2Fwhoami这只是请求目标示例,实际调用仍需完整沙箱签名。生产接口使用 /api/v1/… 与 production 环境,不能仅替换一个凭据前缀。
查看支持的模拟操作
| 方法与逻辑路径 | 所需动作 | 用途 |
|---|---|---|
GET /api/v1/whoami | 有效沙箱凭据 | 当前测试凭据的动作与到期时间;不返回生产账号信息。 |
GET /api/v1/apps | enterprise:ReadApps / distribution:ReadApps | 只列出获准模块的本人合成应用;limit 1–50,after 为上一页完整 A ID,module 可选 enterprise/distribution。 |
POST /api/v1/apps | {module}:CreateApps | 创建合成应用及合成版本;企业模块只接受 ipa。 |
GET /api/v1/apps/{app_id} | {module}:ReadApps | 查询本人合成应用。 |
GET /api/v1/apps/{app_id}/metadata | {module}:ReadApps | 查询名称、备注和并发控制 revision。 |
POST /api/v1/apps/{app_id}/metadata | {module}:UpdateMetadata | revision 必须匹配当前资料;失败后先重新查询。 |
GET /api/v1/apps/{app_id}/versions | {module}:ReadVersions | 查询合成版本,size_bytes=0,没有真实安装包或下载链接。 |
GET /api/v1/apps/{app_id}/statistics | {module}:ReadStatistics | 返回标注 synthetic-fixture 的零统计,不能用于真实安装量判断。 |
GET /api/v1/apps/{app_id}/jobs | enterprise:ReadJobs | 企业合成应用的模拟任务,最多返回 50 条。 |
POST /api/v1/apps/{app_id}/jobs | enterprise:CreateJobs | 指定此应用自己的合成版本;只生成 simulation-only 结果,不运行真实签名。 |
GET /api/v1/jobs/{job_id} | enterprise:ReadJobs | 查询本人模拟任务。 |
POST /api/v1/apps/{app_id}/trash | {module}:TrashApps | 确认后删除此合成应用,不影响任何生产应用或文件。 |
转入真实接入
重新按快速入门配置生产凭据和网站主域名,先完成只读身份查询,再验证自己的应用。需要真实写入时,单独取得相关权限并按业务步骤确认,不能把模拟成功视为生产验收。