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

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

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

注意：

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

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

本文仅说明如何在沙箱环境中调试搜索关键词，非沙箱环境调试通用说明。

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

搜索关键词沙箱调试说明

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

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

注意：

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

目前沙箱钱包端上相关的功能还不支持。

该产品只在新沙箱环境提供支持。

业务用例

搜索关键词管理

提交关键词申请

调用 OpenAPI：alipay.open.search.baseorder.modify

入参示例值：

{
  "biz_type": "SEARCH_ORDER_CREATE",
  "opt_type": "set",
  "biz_data": {
    "appid": "2021000119616038",
    "access_type": "BASE",
    "descprise": "服务描述",
    "spec_code": "SP_MINI_APP",
    "base_items": {
      "key_words": [
        "沙箱1"
      ],
      "can_search": true
    }
  }
}

出参示例值：

{
  "msg": "Success",
  "code": "10000",
  "apply_id": "AP2022122400002452"
}

查询申请审核状态

调用 OpenAPI：alipay.open.search.orderdetail.query

入参示例值：

{
  "biz_data": {
    "apply_id": "AP2022122400002452",
    "apply_type": "BRAND_BOX",
    "brand_template_id": "DEFAULT",
    "spec_code": "SP_MINI_APP"
  },
  "biz_type": "SEARCH_ORDER_DETAIL_QUERY",
  "opt_type": "query"
}

出参示例值：

说明：沙箱环境下关键词申请审核在提交申请后 30s 会自动审核通过，线上环境需要人工审核。

{
  "msg": "Success",
  "code": "10000",
  "data": {
    "app_icon": "https://gw.alipayobjects.com/mdn/rms_d52ffc/afts/img/A*ju84SZwNBSkAAAAAAAAAAABkARQnAQ",
    "can_modify_keyword": false,
    "access_type": "BASE",
    "brand_template_id": "DEFAULT",
    "detail_base_items": {
      "serv_search_keywords": "沙箱1",
      "can_search": "true",
      "key_word": "沙箱1",
      "template_id": "WALLET-SEARCH@boxFunctionCommon",
      "serv_can_search": "true"
    },
    "gmtmodified": "2022-12-24 22:00:40",
    "app_name": "沙箱小程序_2088621957795094",
    "template_name": "二级服务菜单直达",
    "brandbox_orderstatus": {
      "status": "NULL"
    },
    "app_status": "ON_LINE",
    "sub_service_code": "2020061921000201129260",
    "box_order_status": {
      "status": "NULL"
    },
    "appid": "2021000119616038",
    "service_code": "2020061921000201129260",
    "template_id": "WALLET-SEARCH@boxFunctionCommon",
    "describe": "沙箱测试服务描述",
    "order_id": "AP2022122400002452",
    "base_order_status": {
      "order_id": "AP2022122400002452",
      "status": "AGREE"
    },
    "status": "AGREE"
  }
}

批量查询申请单详情

调用 OpenAPI：alipay.open.search.serviceorder.batchquery

入参示例值：

{
  "biz_type": "SEARCH_ORDER_BATCH_QUERY",
  "biz_data": {
    "name": "服务名称",
    "audit_status_list": [
      "AUDIT",
      "AGREE"
    ],
    "apply_type": "BASE",
    "service_code": "2020061921000201129260",
    "page_size": "10",
    "page_num": "1",
    "start_row": "1"
  },
  "opt_type": "query"
}

出参示例值：

{
  "msg": "Success",
  "code": "10000",
  "data": {
    "total_number": 44,
    "page_num": 1,
    "page_data": [
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 22:00:10",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002452",
        "latest": true,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 20:00:51",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002450",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 20:00:09",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002448",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 18:00:54",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002446",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 18:00:12",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002244",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 16:01:11",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002322",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 16:00:30",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002072",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 14:01:01",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002071",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 14:00:19",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002070",
        "latest": false,
        "status": "AGREE"
      },
      {
        "app_name": "沙箱测试服务 001",
        "access_type": "BASE",
        "create_time": "2022-12-24 12:00:56",
        "appid": "2021000119616038",
        "service_code": "2020061921000201129260",
        "order_id": "AP2022122400002240",
        "latest": false,
        "status": "AGREE"
      }
    ],
    "page_size": 10
  }
}

修改已有申请单

调用 OpenAPI：alipay.open.search.baseorder.modify

入参示例值：

说明：修改申请单时需要指定 order_id，值为提交关键词申请步骤返回的 apply_id。

{
  "biz_data": {
    "access_type": "BASE",
    "appid": "2021000119616038",
    "base_items": {
      "key_words": [
        "沙箱3"
      ]
    },
    "order_id": "AP2022122400002452",
    "spec_code": "SP_MINI_APP"
  },
  "biz_type": "SEARCH_ORDER_CREATE",
  "opt_type": "set"
}

出参示例值：

{
  "msg": "Success",
  "code": "10000",
  "apply_id": "AP2022122400002454"
}

沙箱调试

搜索关键词沙箱调试说明#

业务用例#

搜索关键词管理#

提交关键词申请#

查询申请审核状态#

批量查询申请单详情#

修改已有申请单#

搜索关键词沙箱调试说明

业务用例

搜索关键词管理

提交关键词申请

查询申请审核状态

批量查询申请单详情

修改已有申请单