# 上传代码并生成体验版

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

commit

# 功能描述

• 第三方平台需要先通过addToTemplate接口将草稿添加到代码模板库，然后从代码模板库中通过getTemplateList接口获取对应的模板 id（template_id），然后调用本接口可以为已授权的小程序上传代码并生成体验版。

• 使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

# 注意事项

• 如果接口中涉及地理位置相关隐私接口，需要在ext_json参数中配置requiredPrivateInfos
• 上传代码后，需要等检测任务结束后方可提交代码审核，否则提交代码审核时会出现61039报错
• 开发者可以通过getCodePrivacyInfo接口获取检测结果，确认检测任务结束后再提交代码审核
• 不要将上传代码和提交代码审核两个接口一起重试，否则每次上传代码后的检测任务未结束又发起新的检测任务，依旧会出现61039报错。
• 如果代码里使用了地理位置相关接口，但是又尚未在ext_json参数中配置requiredPrivateInfos。那么提交代码审核时会出现61040报错。
• 如果代码里使用了地理位置相关接口，但是该小程序appid又未获得对应地理位置api的权限，那么提交代码审核时会出现61040报错。如果开发者确认不需要使用地理位置相关接口，那么不需要去申请权限，只需要通过提交代码审核接口中的privacy_api_not_use参数进行声明不使用即可

# 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/commit?access_token=ACCESS_TOKEN 

# 第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同

• 该接口所属的权限集id为：18

• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

# 返回参数

# 其他说明

# 关于新增requiredPrivateInfos说明

• 关于地理位置接口新增与相关流程调整可以查看社区公告：https://developers.weixin.qq.com/community/develop/doc/000a02f2c5026891650e7f40351c01
• 7.14后，在代码中使用的地理位置相关接口（共计 8 个，见表1），第三方开发者均需要在 ext_json 参数中 requiredPrivateInfos 配置项中声明
• 在ext_json参数中配置requiredPrivateInfos，其规则为「整体替换」。即如果在app.json里也配置了，那么最终会是ext_json的配置会覆盖app.json配置的requiredPrivateInfos。其余规则可查看下方的「ext_json补充说明」
• 在ext_json参数中配置requiredPrivateInfos示例如下

{
  "template_id": "95",
  "ext_json": "{\"requiredPrivateInfos\":[\"onLocationChange\",\"startLocationUpdate\"]}",
  "user_version": "V1.0",
  "user_desc": "test"
}

• requiredPrivateInfos主要会检查格式是否正确，填入的api名称是否正确，填入的api名称是否有权限，填入的api名称是否互斥。对应的错误码可查看文档末尾的错误码文档。
• requiredPrivateInfos在2022.7.14后才会生效，文档提前更新是为了方便开发者可以提前了解接口的参数变更规则，提前进行调整。

# ext_json补充说明

1. 为了便于第三方平台使用同一个小程序模板为不同的小程序提供服务，第三方可以将自定义信息放置在 ext_json 中，在模板小程序中，可以使用 wx.getExtConfigSync 接口获取自定义信息，从而区分不同的小程序。详见：小程序模板开发
2. ext_json 中的参数可选，参数详见小程序配置;但是，如果是模板id为标准模板库的模板id，则ext_json可支持的参数为：{"extAppid":'', "ext": {}, "window": {}}
3. ext_json 中有限支持 pages，支持配置模板页面的子集（ext_json 中不可新增页面）。
4. ext_json 中有限支持 subPackages，支持配置模板分包及其页面的子集（ext_json 中配置的分包必须已声明于模板中，且不可新增分包页面）。
5. ext_json支持plugins配置，该配置会覆盖模板中的app.json中的plugins配置。关于plugin的使用详情请参考使用插件。
6. 如果代码中已经有配置，则配置的合并规则为：

• ext整体替换
• pages整体替换
• extPages中找到对应页面，同级覆盖page.json
• window同级覆盖
• extAppid直接加到app.json
• networkTimeout同级覆盖
• customOpen整体替换
• tabbar同级覆盖
• functionPages整体替换
• subPackages整体替换
• navigateToMiniProgaramAppIdList：整体替换
• plugins整体替换

补充说明：

• 什么叫同级覆盖？以『window同级覆盖』为例，遍历extjson的window对象成员，如果app.json的window对象存在该对象成员，则覆盖，如果不存在，就添加。
• 什么叫整体替换？以『plugins整体替换』为例，如果app.json存在plugin对象，就用extjson里的plugin对象覆盖，如果不存在，就添加。

特殊字段说明：

# 调用示例

示例说明: 普通模板库代码提交的示例

# 请求数据示例

{
  "template_id": "0",
  "ext_json": "{\"extAppid\":\"\",\"ext\":{\"attr1\":\"value1\",\"attr2\":\"value2\"},\"extPages\":{\"index\":{},\"search/index\":{}},\"pages\":[\"index\",\"search/index\"],\"window\":{},\"networkTimeout\":{},\"tabBar\":{},\"plugin\":{}}",
  "user_version": "V1.0",
  "user_desc": "test"
}


 

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
} 

示例说明: 标准模板库代码提交的示例

# 请求数据示例

{
  "template_id": "0",
  "ext_json": "{\"extAppid\":\"\",\"ext\":{\"attr1\":\"value1\",\"attr2\":\"value2\"},\"window\":{}}",
  "user_version": "V1.0",
  "user_desc": "test"
} 

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
} 

# 错误码