沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的接口调用不会对生产环境中的数据造成任何影响。

沙箱为开放的产品提供有限功能范围的支持（覆盖的功能范围可查看以下业务用例），可以覆盖产品的绝大部分核心链路和对接逻辑，便于开发者快速学习/尝试/开发/调试，推荐开发者遵循业务用例来使用沙箱。

沙箱环境会自动完成或忽略一些场景的业务门槛，例如：开发者无需等待产品开通，即可直接在沙箱环境调用接口，使得开发集成工作可以与商务流程并行，从而提高项目整体的交付效率。

注意：

由于沙箱环境并非 100% 与生产环境一致，接口的实际响应逻辑请以生产环境为准，沙箱环境开发调试完成后，仍然需要在生产环境进行测试验收。

沙箱环境拥有完全独立的数据体系，沙箱环境下返回的数据（例如用户 ID 等）在生产环境中都是不存在的，开发者不可将沙箱环境返回的数据与生产环境中的数据混淆。

本文仅说明如何在沙箱环境中调试收藏，非沙箱环境调试通用说明。

更多沙箱介绍和沙箱控制台使用说明可查看沙箱环境。

收藏沙箱调试说明

沙箱通过业务用例定义支持的功能范围。业务用例描述了典型业务场景下，开发者可通过先后对接哪些接口来实现业务目标，每个业务用例会为开发者提供接口调用时序与参数示例值。

推荐开发者遵循业务用例来使用沙箱。

注意：示例参数值中与沙箱当前账号、应用上下文相关的参数，需开发者自行参照接入指南调用配套接口获取。

业务用例

全局收藏引导活动管理

创建小程序收藏引导活动

调用 OpenAPI：alipay.open.mini.tips.delivery.create（小程序收藏引导投放活动配置创建）

入参示例值：

{
 "delivery_name": "全局收藏引导活动管理",
 "delivery_content": "点击收藏，下次使用更方便",
 "match_type": "GLOBAL",
 "match_url": "/page/web/RnnDXSxhPNyTawjRE",
 "start_time": "2022-09-21 10:23:43",
 "end_time": "2099-09-22 11:23:43"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_create_response": {
  "msg": "Success",
  "code": "10000",
  "delivery_id": "20220928000000108227"
 }
}

注意：沙箱中创建的小程序收藏引导活动，会自动审核通过，线上需等待审核。

查询小程序收藏引导活动是否审核完成

调用 OpenAPI：alipay.open.mini.tips.delivery.query（小程序收藏引导投放活动详情查询）

入参示例值：

{
 "delivery_id": "20220928000000108227"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_query_response": {
  "msg": "Success",
  "start_time": "2022-09-21 10:23:43",
  "code": "10000",
  "delivery_content": "点击收藏，下次使用更方便",
  "delivery_name": "全局收藏引导活动管理",
  "delivery_id": "20220928000000108227",
  "end_time": "2099-09-22 11:23:43",
  "match_type": "GLOBAL",
  "status": "WORKING"
 }
}

暂停小程序收藏引导活动

调用 OpenAPI： alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108227",
 "operate_type": "PAUSE"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

恢复小程序收藏引导活动

调用 OpenAPI： alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108227",
 "operate_type": "RESUME"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

终止小程序收藏引导活动

调用 OpenAPI： alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108227",
 "operate_type": "STOP"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

批量查询小程序收藏引导活动

调用 OpenAPI：alipay.open.mini.tips.delivery.batchquery（小程序收藏引导投放活动配置批量查询）

入参示例值：

{
 "page_number": "1",
 "page_size": "1"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_batchquery_response": {
  "msg": "Success",
  "code": "10000",
  "tips_delivery_list": [{
   "start_time": "2022-09-21 10:23:43",
   "delivery_content": "点击收藏，下次使用更方便",
   "delivery_name": "全局收藏引导活动管理",
   "delivery_id": "20220928000000108227",
   "end_time": "2099-09-22 11:23:43",
   "match_type": "GLOBAL",
   "status": "FINISHED"
  }],
  "total_size": 381,
  "total_pages": 381
 }
}

查询活动汇总数据

调用 OpenAPI：alipay.open.mini.tips.statistic.query（小程序收藏引导汇总数据查询）

入参示例值：

{
 "delivery_id": "20220928000000108227",
 "query_type": "app",
 "start_date": "20220920",
 "end_date": "20220928"
}

出参示例值：

{
 "alipay_open_mini_tips_statistic_query_response": {
  "msg": "Success",
  "total_tips_expo_uv": "3225471",
  "code": "10000",
  "delivery_content": "沙箱测试投放2021000119616038",
  "delivery_id": "20220928000000108227",
  "tips_collect_uv": "8008862",
  "total_app_uv": "4919010",
  "app_collect_cnt": "6903785",
  "tips_expo_uv": "5822207",
  "tips_collect_rate": "34.96",
  "app_uv": "601131",
  "total_tips_collect_uv": "9800195",
  "total_app_collect_cnt": "5786518",
  "total_tips_collect_rate": "47.33"
 }
}

注意：沙箱环境返回的汇总数值均为随机生成，仅作用于验证接口逻辑。

指定页面收藏引导活动管理

创建小程序收藏引导活动

调用 OpenAPI：alipay.open.mini.tips.delivery.create（小程序收藏引导投放活动配置创建）

入参示例值：

{
 "delivery_name": "指定页面收藏引导活动管理",
 "delivery_content": "点击收藏，下次使用更方便",
 "match_type": "TARGETURL",
 "match_url": "/page/web/LDxizf",
 "start_time": "2022-09-21 10:23:43",
 "end_time": "2099-09-22 11:23:43"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_create_response": {
  "msg": "Success",
  "code": "10000",
  "delivery_id": "20220928000000108083"
 }
}

注意：沙箱中创建的小程序收藏引导活动，会自动审核通过，线上需等待审核。

查询小程序收藏引导活动是否审核完成

调用 OpenAPI：alipay.open.mini.tips.delivery.query（小程序收藏引导投放活动详情查询）

入参示例值：

{
 "delivery_id": "20220928000000108083"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_query_response": {
  "msg": "Success",
  "start_time": "2022-09-21 10:23:43",
  "code": "10000",
  "delivery_content": "点击收藏，下次使用更方便",
  "delivery_name": "指定页面收藏引导活动管理",
  "delivery_id": "20220928000000108083",
  "end_time": "2099-09-22 11:23:43",
  "match_type": "TARGETURL",
  "match_url": "/page/web/LDxizf",
  "status": "WORKING"
 }
}

暂停小程序收藏引导活动

调用 OpenAPI：alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108083",
 "operate_type": "PAUSE"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

恢复小程序收藏引导活动

调用 OpenAPI： alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108083",
 "operate_type": "RESUME"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

终止小程序收藏引导活动

调用 OpenAPI： alipay.open.mini.tips.delivery.modify（小程序收藏引导投放活动修改）

入参示例值：

{
 "delivery_id": "20220928000000108083",
 "operate_type": "STOP"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_modify_response": {
  "msg": "Success",
  "code": "10000"
 }
}

批量查询小程序收藏引导活动

调用 OpenAPI：alipay.open.mini.tips.delivery.batchquery（小程序收藏引导投放活动配置批量查询）

入参示例值：

{
 "page_number": "1",
 "page_size": "1"
}

出参示例值：

{
 "alipay_open_mini_tips_delivery_batchquery_response": {
  "msg": "Success",
  "code": "10000",
  "tips_delivery_list": [{
   "start_time": "2022-09-21 10:23:43",
   "delivery_content": "点击收藏，下次使用更方便",
   "delivery_name": "指定页面收藏引导活动管理",
   "delivery_id": "20220928000000108083",
   "end_time": "2099-09-22 11:23:43",
   "match_type": "TARGETURL",
   "match_url": "/page/web/LDxizf",
   "status": "FINISHED"
  }],
  "total_size": 382,
  "total_pages": 382
 }
}

查询活动汇总数据

调用 OpenAPI：alipay.open.mini.tips.statistic.query（小程序收藏引导汇总数据查询）

入参示例值：

{
 "delivery_id": "20220928000000108083",
 "query_type": "app",
 "start_date": "20220920",
 "end_date": "20220928"
}

出参示例值：

{
 "alipay_open_mini_tips_statistic_query_response": {
  "msg": "Success",
  "total_tips_expo_uv": "9286381",
  "code": "10000",
  "delivery_content": "沙箱测试投放2021000119616038",
  "delivery_id": "20220928000000108083",
  "tips_collect_uv": "9677664",
  "total_app_uv": "4284188",
  "app_collect_cnt": "4134410",
  "tips_expo_uv": "4044352",
  "tips_collect_rate": "17.12",
  "app_uv": "9351284",
  "total_tips_collect_uv": "1345863",
  "total_app_collect_cnt": "5565440",
  "total_tips_collect_rate": "15.72"
 }
}

沙箱调试

收藏沙箱调试说明#

业务用例#

全局收藏引导活动管理#

创建小程序收藏引导活动#

查询小程序收藏引导活动是否审核完成#

暂停小程序收藏引导活动#

恢复小程序收藏引导活动#

终止小程序收藏引导活动#

批量查询小程序收藏引导活动#

查询活动汇总数据#

指定页面收藏引导活动管理#

创建小程序收藏引导活动#

查询小程序收藏引导活动是否审核完成#

暂停小程序收藏引导活动#

恢复小程序收藏引导活动#

终止小程序收藏引导活动#

批量查询小程序收藏引导活动#

查询活动汇总数据#

收藏沙箱调试说明

业务用例

全局收藏引导活动管理

创建小程序收藏引导活动

查询小程序收藏引导活动是否审核完成

暂停小程序收藏引导活动

恢复小程序收藏引导活动

终止小程序收藏引导活动

批量查询小程序收藏引导活动

查询活动汇总数据

指定页面收藏引导活动管理

创建小程序收藏引导活动

查询小程序收藏引导活动是否审核完成

暂停小程序收藏引导活动

恢复小程序收藏引导活动

终止小程序收藏引导活动

批量查询小程序收藏引导活动

查询活动汇总数据