小游戏

权限集列表

小游戏内购

小游戏运营

收藏

消息

开发 > 服务端 >  >  > 沙箱调试

更新时间：2024-10-23 18:08:05

文档更新记录 >

集成工具

收藏

订阅更新

我的文档

设置

返回文档

沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的接口调用不会对生产环境中的数据造成任何影响。
沙箱为开放的产品提供 有限功能范围的支持（覆盖的功能范围参见下面的业务用例），可以覆盖产品的绝大部分核心链路和对接逻辑，便于开发者快速学习/尝试/开发/调试，推荐开发者遵循业务用例来使用沙箱。
沙箱环境会自动完成或忽略一些场景的业务门槛，例如：开发者无需等待产品签约，即可直接在沙箱环境调用接口，使得开发集成工作可以与商务流程并行，从而提高项目整体的交付效率。
注意：
●由于沙箱环境并非 100% 与生产环境一致，接口的实际响应逻辑请以生产环境为准，沙箱环境开发调试完成后，仍然需要在生产环境进行测试验收。
●沙箱环境拥有完全独立的数据体系，沙箱环境下返回的数据（例如用户 id 等）在生产环境中都是不存在的，开发者不可将沙箱环境返回的数据与生产环境中的数据混淆。
●本文仅说明如何在沙箱环境中调试小程序-消息，非沙箱环境调试通用说明。
更多沙箱介绍和沙箱控制台使用说明可查看 沙箱环境。
小程序-消息沙箱调试说明
沙箱通过业务用例定义支持的功能范围。业务用例描述了典型业务场景下，开发者可通过先后对接哪些接口来实现业务目标，每个业务用例会为开发者提供接口调用时序与参数示例值。
推荐开发者遵循业务用例来使用沙箱。
注意：示例参数值中与沙箱当前账号、应用上下文相关的参数，需开发者自行参照接入指南调用配套接口获取。
配套工具
沙箱环境提供了基于 restful api 的方式来操作消息模板以供 openapi 调用时使用。
订阅沙箱支持的消息模板
旧沙箱环境订阅消息模版方式：
get http://sandboxsys.sx.alipaydev.com/prods/msgprod/template/1/${appid}/${sandboxuserid}
新沙箱环境订阅消息模版方式：
get http://sandboxsys.dl.alipaydev.com/prods/msgprod/template/1/${appid}/${sandboxuserid}
说明：需要将路径中的变量替换成实际值，其中 ${appid} 替换为沙箱小程序 appid，${sandboxuserid} 为订阅消息的沙箱用户 id。

业务用例
接入小程序支付消息
确认接入小程序支付消息
调用 openapi：
入参示例值：
无请求参数，使用沙箱预置的小程序 appid 发起调用即可
出参示例值：

接入非小程序支付消息
查询可关联 pid
调用 openapi：
入参示例值：

出参示例值：

关联 pid 和小程序
调用 openapi：
入参示例值：

出参示例值：

查询已关联 pid
调用 openapi：
入参示例值：

出参示例值：

取消关联 pid 和小程序
调用 openapi：
入参示例值：

出参示例值：

接入订阅消息
小程序中唤起消息订阅弹窗
调用 jsapi：my.requestsubscribemessage
说明：在沙箱环境中可以通过配套工具完成消息的订阅。
服务端发送订阅消息
调用 openapi：
入参示例值：

出参示例值：

查询订阅关系
调用 openapi：
入参示例值：

出参示例值：