微信小程序开发文档 第41页

场景值 基础库 1.1.0 开始支持，低版本需做兼容处理。 场景值用来描述用户进入小程序的路径。完整场景值的含义请查看场景值列表。 由于Android系统限制，目前还无法获取到按 Home 键退出到桌面，然后从桌面再次进小程序的场景值，对于这种情况，会保留上一次的场景值。 获取场景值 开发者可以通过下列方式获取场景值： 对于小程序，可以在 App 的 onLaunch 和 onShow，或wx.getLaunchOptionsSync 中获取上述场景值。 对于小游戏，可以在 wx.getLaunchOptionsSync 和 wx.onShow 中获取上述场景值 返回来源信息的场景 部分场景值下还可以获取来源应用、公众号或小程序的appId。获取方式请参考对应API的参考文档。 场景值 场景 appId含义 1020 公众号 profile 页相关小程序列表 来源公众号 1035 公众号自定义菜单 来源公众号 1036 App 分享消息卡片 来源App 1037 小程序打开小程序 来源小程序 1038 从另一个小程序返回 来源小程序 1043 公众号模板消息 来源公众号

小程序协同工作和发布 在中大型的公司里，人员的分工非常仔细，一般会有不同岗位角色的员工同时参与同一个小程序项目。为此，小程序平台设计了不同的权限管理使得项目管理者可以更加高效管理整个团队的协同工作。 以往我们在开发完网页之后，需要把网页的代码和资源放在服务器上，让用户通过互联网来访问。在小程序的平台里，开发者完成开发之后，需要在开发者工具提交小程序的代码包，然后在小程序后台发布小程序，用户可以通过搜索或者其它入口来进入该小程序。 在这一章我们会把团队的协同工作的注意事项和小程序发布前后涉及的概念和流程做一些介绍。 协同工作 如果你只是一个人开发小程序，可以暂时先跳过这部分，如果是一个团队需要先了解一些概念。 多数情况下，一个团队多人同时参与同一个小程序项目，每个角色所承担的工作或者权限不一样，中大公司的分工更为仔细。为了更形象的表达团队不同角色的关系以及权限的管理，我们通过虚拟一个项目成员组织结构来描述日常如何协同合作完成一个小程序的发布，组织关系如图5-1所示。 ​ 图5-1 虚拟小程序项目组 项目管理成员负责统筹整个项目的进展和风险、把控小程序对外发布的节奏，产品组提出需求，设计组与产品讨论并对需求进行抽象，设计出可视化流程与图形，输出设计方案。开发组依据设计方案，进行程序代码的编写，代码编写完成后，产品组与设计组体验小程序的整体流程，测试组编写测试用例并对小程序进行各种边界测试。项目一般的成员构成与工作流程如图5-2所示。 ​ 图5-2 提需求到发布小程序的流程 小程序成员管理 小程序成员管理包括对小程序项目成员及体验成员的管理。 项目成员：表示参与小程序开发、运营的成员，可登录小程序管理后台，包括运营者、开发者及数据分析者。管理员可在“成员管理”中添加、删除项目成员，并设置项目成员的角色。 体验成员：表示参与小程序内测体验的成员，可使用体验版小程序，但不属于项目成员。管理员及项目成员均可添加、删除体验成员。 不同项目成员拥有不同的权限，从而保证小程序开发安全有序。 权限 运营者 开发者 数据分析者 开发者权限 √ 体验者权限 √ √ √ 登录 √ √ √ 数据分析 √ 微信支付 √ 推广 √ 开发管理 √ 开发设置 √ 暂停服务 √ 解除关联公众号 √ 腾讯云管理 √ 小程序插件 √ 游戏运营管理 √ 各权限功能说明 开发者权限：可使用小程序开发者工具及开发版小程序进行开发 体验者权限：可使用体验版小程序 登录：可登录小程序管理后台，无需管理员确认 数据分析：使用小程序统计模块功能查看小程序数据 微信支付：使用小程序微信支付（虚拟支付）模块 推广：使用小程序流量主、广告主模块 开发管理：小程序提交审核、发布、回退 开发设置：设置小程序服务器域名、消息推送及扫描普通链接二维码打开小程序 暂停服务设置：暂停小程序线上服务 解除关联公众号：可解绑小程序已关联的公众号 小程序插件：可进行小程序插件开发管理和设置 游戏运营管理：可使用小游戏管理后台的素材管理、游戏圈管理等功能 需要留意，项目管理者控制整个小程序的发布、回退、下架等敏感操作，不应把敏感操作的权限分配给不相关人员 小程序的版本 一般的软件开发流程，开发者编写代码自测开发版程序，直到程序达到一个稳定可体验的状态时，开发者会把这个体验版本给到产品经理和测试人员进行体验测试，最后修复完程序的Bug后发布供外部用户正式使用。小程序的版本根据这个流程设计了小程序版本的概念，如表5-3所示。 表5-3 小程序的版本 权限 说明 开发版本 使用开发者工具，可将代码上传到开发版本中。 开发版本只保留每人最新的一份上传的代码。 点击提交审核，可将代码提交审核。开发版本可删除，不影响线上版本和审核中版本的代码。 体验版本 可以选择某个开发版本作为体验版，并且选取一份体验版。 审核中版本 只能有一份代码处于审核中。有审核结果后可以发布到线上，也可直接重新提交审核，覆盖原审核版本。 线上版本 线上所有用户使用的代码版本，该版本代码在新版本代码发布后被覆盖更新。 考虑到项目是协同开发的模式，一个小程序可能同时由多个开发者进行开发，往往开发者在小程序开发者工具上编写完代码后需要到手机进行真机体验，所以每个开发者拥有自己对应的一个开发版本。因为处于开发中的版本是不稳定的，开发者随时会修改代码覆盖开发版，为了让测试和产品经理有一个完整稳定的版本可以体验测试，小程序平台允许把其中一个开发版本设置成体验版，因此建议在项目开发阶段特殊分配一个开发角色，用于上传稳定可供体验测试的代码，并把他上传的开发版本设置成体验版。 发布上线 一个小程序从开发完到上线一般要经过 预览-> 上传代码 -> 提交审核 -> 发布等步骤。 预览 使用开发者工具可以预览小程序，帮助开发者检查小程序在移动客户端上的真实表现。 点击开发者工具顶部操作栏的预览按钮，开发者工具会自动打包当前项目，并上传小程序代码至微信的服务器，成功之后会在界面上显示一个二维码。使用当前小程序开发者的微信扫码即可看到小程序在手机客户端上的真实表现。 上传代码 同预览不同，上传代码是用于提交体验或者审核使用的。 点击开发者工具顶部操作栏的上传按钮，填写版本号以及项目备注，需要注意的是，这里版本号以及项目备注是为了方便管理员检查版本使用的，开发者可以根据自己的实际要求来填写这两个字段。 上传成功之后，登录小程序管理后台 – 开发管理 – 开发版本 就可以找到刚提交上传的版本了。 可以将这个版本设置 体验版 或者是 提交审核 提交审核 为了保证小程序的质量，以及符合相关的规范，小程序的发布是需要经过审核的。 在开发者工具中上传了小程序代码之后，登录 小程序管理后台 – 开发管理 – 开发版本 找到提交上传的版本。 在开发版本的列表中，点击 提交审核 按照页面提示，填写相关的信息，即可以将小程序提交审核。 需要注意的是，请开发者严格测试了版本之后，再提交审核， 过多的审核不通过，可能会影响后续的时间。 发布 审核通过之后，管理员的微信中会收到小程序通过审核的通知，此时登录 小程序管理后台 – 开发管理...

logistics.updatePath 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 更新运单轨迹 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/delivery/path/update?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 token string 是 商户侧下单事件中推送的 Token 字段 waybill_id string 是 运单 ID action_time number 是 轨迹变化 Unix 时间戳 action_type number 是 轨迹变化类型 action_msg string 是 轨迹变化具体信息说明，展示在快递轨迹详情页中。若有手机号码，则直接写11位手机号码。使用UTF-8编码。 action_type 的合法值 值 说明 最低版本 100001 揽件阶段-揽件成功 100002 揽件阶段-揽件失败 100003 揽件阶段-分配业务员 200001 运输阶段-更新运输轨迹 300002 派送阶段-开始派送 300003 派送阶段-签收成功 300004 派送阶段-签收失败 400001 异常阶段-订单取消 400002 异常阶段-订单滞留 返回值 Object 属性 类型 说明 errcode number 错误码 errmsg string 错误信息 errcode 的合法值 值 说明 最低版本 0 成功 -1 系统失败 40199 运单 ID 错误，未查到运单 9300507 Token 不正确 请求数据示例 { "token": "TOKEN", "waybill_id": "12345678901234567890", "action_time": 1533052800, "action_type": 300002, "action_msg": "丽影邓丽君【18666666666】正在派件" } 返回数据示例 { "errcode": 0, "errmsg": "ok" }...

logistics.updateBusiness 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 更新商户审核结果 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/delivery/service/business/update?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 shop_app_id string 是 商户的小程序AppID，即审核商户事件中的 ShopAppID biz_id string 是 商户账户 result_code number 是 审核结果，0 表示审核通过，其他表示审核失败 result_msg string 否 审核错误原因，仅 result_code 不等于 0 时需要设置 返回值 Object 属性 类型 说明 errcode number 错误码 errmsg string 错误信息 errcode 的合法值 值 说明 最低版本 0 成功 -1 其他错误 40013 非法的商户小程序 AppID 9300525 商户未申请过审核 请求数据示例 { "shop_app_id": "wxABCD", "biz_id": "xyz", "result_code": 0, "result_msg": "审核通过" } 返回数据示例 { "errcode": 0, "errmsg": "ok" } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.logistics.updateBusiness 需在 config.json 中配置 logistics.updateBusiness API 的权限，详情 请求参数 属性 类型 默认值 必填 说明 shopAppId string 是 商户的小程序AppID，即审核商户事件中的 ShopAppID bizId string 是 商户账户 resultCode number 是 审核结果，0 表示审核通过，其他表示审核失败 resultMsg string 否 审核错误原因，仅...

logistics.previewTemplate 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 预览面单模板。用于调试面单模板使用。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/delivery/template/preview?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 waybill_id string 是 运单 ID waybill_template string 是 面单 HTML 模板内容（需经 Base64 编码） waybill_data string 是 面单数据。详情参考下单事件返回值中的 WaybillData custom Object 是 商户下单数据，格式是商户侧下单 API 中的请求体 返回值 Object 属性 类型 说明 waybill_id string 运单 ID rendered_waybill_template string 渲染后的面单 HTML 文件（已经过 Base64 编码） errcode number 错误码 errmsg string 错误信息 errcode 的合法值 值 说明 最低版本 0 成功 -1 其他错误 40199 运单 ID 错误，未查到运单 9300507 Token 不正确 9300502 预览模板中出现该错误，一般是waybill_data数据错误 9300512 模板格式错误，渲染失败 请求数据示例 { "waybill_id": "1234567890123", "waybill_data": "##ZTO_mark##11-22-33##ZTO_bagAddr##广州##", "waybill_template": "PGh0bWw+dGVzdDwvaHRtbD4=", "custom": { "order_id": "012345678901234567890123456789", "openid": "oABC123456", "delivery_id": "ZTO", "biz_id": "xyz", "custom_remark": "易碎物品", "sender": { "name": "张三", "tel": "18666666666", "mobile": "020-88888888", "company": "公司名",...

logistics.getContact 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 获取面单联系人信息 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/delivery/contact/get?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 token string 是 商户侧下单事件中推送的 Token 字段 waybill_id string 是 运单 ID 返回值 Object 属性 类型 说明 waybill_id string 运单 ID sender Array.<Object> 发件人信息 receiver Array.<Object> 收件人信息 errcode number 错误码 errmsg string 错误信息 sender 的结构 属性 类型 说明 address string 地址，已经将省市区信息合并 name string 用户姓名 tel string 座机号码 mobile string 手机号码 receiver 的结构 属性 类型 说明 address string 地址，已经将省市区信息合并 name string 用户姓名 tel string 座机号码 mobile string 手机号码 errcode 的合法值 值 说明 最低版本 0 成功 -1 其他错误 40199 运单 ID 错误，未查到运单 9300507 Token 不正确 请求数据示例 { "token": "TOKEN", "waybill_id": "12345678901234567890" } 返回数据示例 { "waybill_id": "12345678901234567890", "sender": {...

logistics.updatePrinter 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 配置面单打印员，可以设置多个，若需要使用微信打单 PC 软件，才需要调用。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/business/printer/update?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 openid string 是 打印员 openid update_type string 是 更新类型 tagid_list string 否 用于平台型小程序设置入驻方的打印员面单打印权限，同一打印员最多支持10个tagid，使用半角逗号分隔，中间不加空格，如填写123,456，表示该打印员可以拉取到tagid为123和456的下的单，非平台型小程序无需填写该字段 update_type 的合法值 值 说明 最低版本 bind 绑定 unbind 解除绑定 返回值 Object 属性 类型 说明 errcode number 错误码 errmsg string 错误信息 errcode 的合法值 值 说明 最低版本 0 成功 -1 系统失败 9300517 update_type 不正确 请求数据示例 { "openid": "oJ4v0wRAfiXcnIbM3SgGEUkTw3Qw", "update_type": "bind", "tagid_list": "123,456" } 返回数据示例 { "errcode": 0, "errmsg": "ok" } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.logistics.updatePrinter 需在 config.json 中配置 logistics.updatePrinter API 的权限，详情 请求参数 属性 类型 默认值 必填 说明 openid string 是 打印员 openid updateType string 是 更新类型 tagidList string 否 用于平台型小程序设置入驻方的打印员面单打印权限，同一打印员最多支持10个tagid，使用半角逗号分隔，中间不加空格，如填写123,456，表示该打印员可以拉取到tagid为123和456的下的单，非平台型小程序无需填写该字段 updateType 的合法值 值 说明 最低版本 bind 绑定...

logistics.getQuota 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 获取电子面单余额。仅在使用加盟类快递公司时，才可以调用。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/business/quota/get?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 delivery_id string 是 快递公司ID，参见getAllDelivery biz_id string 是 快递公司客户编码 返回值 Object 属性 类型 说明 quota_num number 电子面单余额 请求数据示例 { "delivery_id": "YTO", "biz_id": "xyz" } 返回数据示例 { "quota_num": 210 } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.logistics.getQuota 需在 config.json 中配置 logistics.getQuota API 的权限，详情 请求参数 属性 类型 默认值 必填 说明 deliveryId string 是 快递公司ID，参见getAllDelivery bizId string 是 快递公司客户编码 返回值 Object 属性 类型 说明 quotaNum number 电子面单余额 请求数据示例 const cloud = require('wx-server-sdk') cloud.init() exports.main = async (event, context) => { try { const result = await cloud.openapi.logistics.getQuota({ deliveryId: 'YTO', bizId: 'xyz' }) return result } catch (err) { return err } } 返回数据示例 { "quotaNum": 210,...

logistics.getPrinter 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 获取打印员。若需要使用微信打单 PC 软件，才需要调用。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 GET https://api.weixin.qq.com/cgi-bin/express/business/printer/getall?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 返回值 Object 返回数据示例 { "count": 2, "openid": [ "oABC", "oXYZ" ], "tagid_list": [ "123", "456" ] } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.logistics.getPrinter 需在 config.json 中配置 logistics.getPrinter API 的权限，详情 返回值 Object 请求示例 const cloud = require('wx-server-sdk') cloud.init() exports.main = async (event, context) => { try { const result = await cloud.openapi.logistics.getPrinter({}) return result } catch (err) { return err } } 返回数据示例 { "count": 2, "openid": [ "oABC", "oXYZ" ], "tagidList": [ "123", "456" ], "errMsg": "openapi.logistics.getPrinter:ok" }

logistics.getPath 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 查询运单轨迹 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cgi-bin/express/business/path/get?access_token=ACCESS_TOKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 order_id string 是 订单 ID，需保证全局唯一 openid string 否 用户openid，当add_source=2时无需填写（不发送物流服务通知） delivery_id string 是 快递公司ID，参见getAllDelivery waybill_id string 是 运单ID 返回值 Object 属性 类型 说明 openid string 用户openid delivery_id string 快递公司 ID waybill_id string 运单 ID path_item_num number 轨迹节点数量 path_item_list Array.<Object> 轨迹节点列表 path_item_list 的结构 属性 类型 说明 action_time number 轨迹节点 Unix 时间戳 action_type number 轨迹节点类型 action_msg string 轨迹节点详情 action_type 的合法值 值 说明 最低版本 100001 揽件阶段-揽件成功 100002 揽件阶段-揽件失败 100003 揽件阶段-分配业务员 200001 运输阶段-更新运输轨迹 300002 派送阶段-开始派送 300003 派送阶段-签收成功 300004 派送阶段-签收失败 400001 异常阶段-订单取消 400002 异常阶段-订单滞留 请求数据示例 { "order_id": "01234567890123456789", "openid": "oABC123456", "delivery_id": "SF", "waybill_id": "123456789" } 返回数据示例 { "openid": "OPENID", "delivery_id": "SF",...