跳转到主要内容
1签 (OneSign)

使用沙箱与只读调试

本页内容

先在沙箱练习已支持的模拟操作,再用自己的生产凭据验证真实只读接口。沙箱和生产使用不同凭据、入口和签名环境,不能互换。

选择调试方式

方式适合做什么数据范围
沙箱练习已经支持的请求结构、签名和模拟流程模拟数据,不能证明真实上传、签名或付款已经成功
开发者中心只读调试核对本人已授权资源的真实读取结果受当前账号和 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/appsenterprise: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}:UpdateMetadatarevision 必须匹配当前资料;失败后先重新查询。
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}/jobsenterprise:ReadJobs企业合成应用的模拟任务,最多返回 50 条。
POST /api/v1/apps/{app_id}/jobsenterprise:CreateJobs指定此应用自己的合成版本;只生成 simulation-only 结果,不运行真实签名。
GET /api/v1/jobs/{job_id}enterprise:ReadJobs查询本人模拟任务。
POST /api/v1/apps/{app_id}/trash{module}:TrashApps确认后删除此合成应用,不影响任何生产应用或文件。

转入真实接入

重新按快速入门配置生产凭据和网站主域名,先完成只读身份查询,再验证自己的应用。需要真实写入时,单独取得相关权限并按业务步骤确认,不能把模拟成功视为生产验收。