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

全局配置 小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象，有以下属性： 配置项 属性 类型 必填 描述 最低版本 entryPagePath string 否 小程序默认启动首页 pages string[] 是 页面路径列表 window Object 否 全局的默认窗口表现 tabBar Object 否 底部 tab 栏的表现 networkTimeout Object 否 网络超时时间 debug boolean 否 是否开启 debug 模式，默认关闭 functionalPages boolean 否 是否启用插件功能页，默认关闭 2.1.0 subpackages Object[] 否 分包结构配置 1.7.3 workers string 否 Worker 代码放置的目录 1.9.90 requiredBackgroundModes string[] 否 需要在后台使用的能力，如「音乐播放」 plugins Object 否 使用到的插件 1.9.6 preloadRule Object 否 分包预下载规则 2.3.0 resizable boolean 否 PC 小程序是否支持用户任意改变窗口大小（包括最大化窗口）；iPad 小程序是否支持屏幕旋转。默认关闭 2.3.0 usingComponents Object 否 全局自定义组件配置 开发者工具 1.02.1810190 permission Object 否 小程序接口权限相关设置 微信客户端 7.0.0 sitemapLocation string 是 指明 sitemap.json 的位置 style string 否 指定使用升级后的weui样式 2.8.0 useExtendedLib Object 否 指定需要引用的扩展库 2.2.1 entranceDeclare Object 否 微信消息用小程序打开 微信客户端7.0.9 darkmode boolean 否 小程序支持 DarkMode 2.11.0 themeLocation string 否 指明 theme.json 的位置，darkmode为true为必填 开发者工具 1.03.2004271 lazyCodeLoading...

文件结构 MINA程序包含一个描述整体程序的app和多个描述各自页面的page。 一个MINA程序主体部分由三个文件组成，必须放在项目的根目录，如下： 文件 必需 作用 app.js 是 小程序逻辑 app.json 是 小程序公共设置 app.wxss 否 小程序公共样式表 一个MINA页面由四个文件组成，分别是： 文件类型 必须 作用 wxml 是 页面结构 wxss 否 页面样式表 json 否 页面配置 js 是 页面逻辑 注意：为了方便开发者减少配置项，我们规定描述页面的这四个文件必须具有相同的路径与文件名。

checkrealnameinfo 接入微信城市服务，开发者小程序可以使用实名信息校验接口。主要实现的功能是，在用户同意情况下，通过微信城市服务去校验用户（或业务方）输入的实名信息，是否正确且与用户在“开通微信支付”时，预留的实名信息一致。此接口与接入城市服务的开放范围一致，需申请权限可点击此处查看详细说明。 接口文档说明 1、业务流程说明 第一步：业务方小程序的界面，需要实现实名信息校验时，需根据接口文档提供的path跳转至微信城市服务提供的小程序授权页。 第二步：用户在微信授权页点击同意确认后，微信会回跳至业务方小程序，并带上code参数（code参数包含在返回的extraData）。 第三步：业务方页面获得code之后，需要通过后台调用微信提供的后台API，进行实名信息的校验。校验完成后，业务方再根据具体情况，完成自有的业务流程。 2、获取code参数 根据4.1描述的步骤，调用后台API校验实名信息时，需要先获取code参数。获取方式如下： 1、请求方式： 跳转至微信城市服务提供的appid和path appid：wx308bd2aeb83d3345 path：subPages/city/wxpay-auth/main 2、应答方式： 用户完成确认同意后，会跳回至业务方小程序，并在extraData字段中带上调用后台接口所需的code，即extraData中的code字段。 如需了解如何处理extraData字段，可以点击此处查看更多 3、后台校验实名信息的API 注：此后台API，与小程序API使用方式一致。如需了解小程序API使用方式，请点击此处查看详细说明 1、请求方式：POST 2、请求地址： https://api.weixin.qq.com/intp/realname/checkrealnameinfo?access_token=ACCESSTOKEN 说明：此处的access_token获取方式，可点击此处参考详细说明 3、请求格式：JSON 4、请求参数： 字段 类型 说明 备注 openid string 用户在业务方下的openid 与申请权限时提供的业务方的小程序appid保持一致 real_name string 姓名 需要校验的姓名 cred_id string 证件号 需要校验的证件号 cred_type string 默认为1，即身份证 目前暂只支持身份证 code string 回调获取的code 通过小程序回跳获取的code参数 5、返回字段： 字段 类型 说明 备注 errcode int 0为接口调用成功 错误码 errmsg string 失败时的错误提示 错误原因 verify_openid string V_OP_NA:用户暂未实名认证；V_OP_NM_MA:用户与姓名匹配；V_OP_NM_UM:用户与姓名不匹配。 有多个结果时用分号”;”连接； verify_real_name string 当verify_openid 为V_OP_NM_MA 时返回:V_NM_ID_MA:姓名与证件号匹配；V_NM_ID_UM:姓名与证件号不匹配。 校验结果

auto-fill 接入微信城市服务，业务方可以使用小程序auto-fill组件功能，获取用户首次填写过的表单的信息。需接入auto-fill组件，点击此处查看详细说明。 组件调用说明 1、字段描述 auto­-fill字段由两部分组成，(group.key)表示分组和具体字段，相同group的字段可以关联在一起，用户的一次选择可以完成全部的填写。另外，开发时，需要给input、textarea、picker指定auto­fill字段。 字段定义及具体的group和key字段，详见详见下表。（申请权限时，可选择本表中的group_key，或key） group_key key 字段定义 公共字段 (可以和任意group_key组合) name 姓名 id_card_num 身份证号 phone 手机号 email 邮箱 基础信息 base_info sex 性别 birthday 生日 nationality 国籍 驾驶证信息 driver_licence_info licence_num 驾驶证号 licence_file_num 驾驶证档案编号 行驶证信息 driver_licence_info licence_plate_num 行驶证车牌号 engine_num 行驶证发动机号 licence_hassis_num 行驶证车架号 地址 address_info nationality 国家 address 省 address_detail 详细地址 postcode 邮编 护照 passport passport_num 护照号 validity 护照有效期 issue_at 签发地 first_name_zh 名字（中文） last_name_zh 姓氏（中文） first_name_en 名字（英文） last_name_en 姓氏（英文） birth_place 户口出生地 residence_place 户口所在地 港澳通行证 hk_macau_passport passport_num 港澳通行证号 validity 护照有效期 issue_at 签发地 first_name_zh 名字（中文） last_name_zh 姓氏（中文） first_name_en 名字（英文） last_name_en 姓氏（英文） birth_place 户口出生地 residence_place 户口所在地 社保卡 social_security card_num 社保卡号 调用字段填写表单时，公共字段使用，需调用对应group，如：base_info.name，base_info.phone；passport.name, passport.phone。其它group字段直接调用，如：base_info.email。 2、form表单示例 <form bindsubmit="submit"> <input class="weui-input" placeholder="姓名" auto-fill="address_info.name" /> <input class="weui-input" placeholder="手机" auto-fill="address_info.phone" /> <input class="weui-input" placeholder="身份证" auto-fill="address_info.id_card_num" /> <button form-type="submit">submit</button> </form> 3、测试案例 除以上文档，还可下载以下测试案例，测试试用。 点击下载测试案例

results-page 接入微信城市服务，业务方需确保功能的闭环服务体验，需接入消息通路。点击此处查看城市服务消息通路说明。 调用方法 1、接口调用请求 请求方式：POST 请求地址：https://api.weixin.qq.com/cityservice/sendmsgdata?access_token=ACCESS_TOKEN （1）获取access_token方式请点击此处查看；获取openid方式请点击此处查看。 （2）通过小程序提供服务时，需使用小程序用户 openid ，并使用与小程序关联的、且申请了“消息通路”的公众号的 access_token 2、以POST方式传入json格式的参数 （1）模板申请成功后，将会分配biz_template_id，并根据模板推送渠道不同分别提供样式ID：result_page_style_id、deal_msg_style_id、card_style_id。 （2）调用接口时，通过POST方式传入json格式的以下参数，所有参数的数据类型均为“字符串”，且字符集默认使用UTF-8。 字段说明 参数 说明 是否必填 openid 用户唯一标识 必填 biz_template_id 城市服务分配给公众号的模板id 必填 result_page_style_id 结果页样式id 含结果页必填 deal_msg_style_id 办事记录样式id 含办事记录必填 card_style_id 页卡样式id 含页卡必填 order_no 订单号，同一订单号的办事记录会合并 必填 url 跳转链接，用于服务通知、结果页、待办提醒 含结果页必填 data 模板json数据，其中color字段只对服务通知有效 必填 参数示例 { "openid":"OPENID", "biz_template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY", "result_page_style_id":"cUjfPSEtwasWQFsJ5PXo218PexBaHy5jg_peVDe4WkY", "deal_msg_style_id":"cUjfPSEtwasWQFsJ5PXo24LeNjWbwMObXSHPNjVZ0uQ", "card_style_id":"cUjfPSEtwasWQFsJ5PXo2z8LSM0Q6FH05DCerWEVkDs", "order_no":"ORDER_NO", "url":"http://weixin.qq.com/download", "data":{ "first": { "value":"恭喜你购买成功！", "color":"#173177" }, "keynote1":{ "value":"巧克力", "color":"#173177" }, "keynote2": { "value":"39.8元", "color":"#173177" }, "keynote3": { "value":"2014年9月22日", "color":"#173177" }, "remark":{ "value":"欢迎再次购买！", "color":"#173177" } } } 注：data为数组时用[ ]括起“data”字段内数据。 3、返码说明 在调用消息通路接口后，返回JSON数据包： 返回结果 返回码 说明 result_page_url 结果页url 需跳转至该url，替代原有的服务结果页面。如未传入result_page_style_id，则调用后result_page_url返回为空。 errcode 48001 api未授权 errcode 40097 1.参数错误。2.或openid不来自有“消息通路”api权限的公众号 errcode 82020 未关注公众号的用户，从未在城市服务访问过服务 errcode 82021 未关注公众号的用户，未在近30天内通过城市服务访问服务 errcode 82022 未关注公众号的用户，通过城市服务访问服务后，30天内被下发数超过10次（医疗行业超过20次） errcode 82023 未关注公众号的用户，1个小时内被下发次数超过5次 errcode 82024 order_no异常，例如所有用户的业务订单号都用同一个 errcode 82025 URL无效 errcode 82026 1.服务已下线。2.或服务在审核中且审核期超过了30天 正常时的返回JSON数据包示例： { "errcode":0, "errmsg":"ok", "result_page_url":"https://city.weixin.qq.com/static/resultpagenew.html?openid=ont-9vjAcIdSU-LgB7ubALAVJO9U&biz_template_id=ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY #wechat_redirect"...

查询欠费用户列表 微信后台会定时（每天6点开始）获取所有欠费用户列表，并提供接口查询列表接口，此后如果有用户完成欠费缴纳会在收到成功支付通知时删除记录。 1、请求参数 参数名称 类型 必选 备注 start_openid string N 开始的openid,从头开始填空，start_openid不会包含在返回结果中 limit int Y 最大返回数量(0,10000] 2、返回参数 参数名称 类型 必选 备注 errcode int Y 错误码 errmsg string Y 错误信息 list array N 返回欠费用户列表 其中list的每一项的内容如下： 参数名称 类型 必选 备注 openid string Y 用户openid fee int Y 欠费金额 create_time int Y 更新的时间 out_user_id string N 用户在业主方的id，当设置了注册回调后才有

设置线路接口 设置公交/地铁线路。 1、请求参数 参数名称 类型 必选 备注 type int Y 类型 0-地铁 1-公交 conf object Y 设置的线路配置 其中conf的内容如下： 参数名称 类型 必选 备注 line_list away Y 线路信息 其中conf.line_list的每一项内容如下： 参数名称 类型 必选 备注 id int Y 线路的唯一id start_station string Y 起点站 end_station string Y 终点站 line_name string Y 线路名称 2、返回参数 参数名称 类型 必选 备注 errcode int Y 错误码 errmsg string Y 错误信息

查询线路接口 查询设置的公交/地铁线路。 1、请求参数 参数名称 类型 必选 备注 type int Y 类型 0-地铁 1-公交 2、返回参数 参数名称 类型 必选 备注 errcode int Y 错误码 errmsg string Y 错误信息 results object N 线路信息 其中results的内容如下： 参数名称 类型 必选 备注 line_list away Y 线路信息 其中results.line_list的每一项内容如下： 参数名称 类型 必选 备注 id int Y 线路的唯一id start_station string Y 起点站 end_station string Y 终点站 line_name string Y 线路名称

欠费支付 微信后台向业主方通知用户支付成功（支付失败时无通知）。 1、请求参数 参数名称 类型 必选 备注 appid string Y 小程序appid mch_id string Y 支付商户号 nonce_str string Y 随机字符串 encrypted_data string Y 使用AESCBCPKCS7PADDING iv string Y 用于解密的IV(base64) sign string Y 1~5字段的签名 encrypted_data解密后的数据 参数名称 类型 必选 备注 out_user_id string Y 业主后台对用户的标识，设置过注册回调接口时存在 openid string Y 用户openid bank_type string Y 支付类型,采用字符串类型的银行标识 total_fee int Y 支付费用 transaction_id string Y 微信支付单号 time_end string Y 格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010 repay_no string Y 欠费单号 order_no array Y 与本欠费单号相关联的乘车码单号（存在一次支付多笔乘车欠费的情况），每一项的内容为string order array Y 与本欠费单号相关联的乘车码单号的详细信息 其中order的每一项内容如下： 参数名称 类型 必选 备注 order_no string Y 乘车码单号 attach string Y 免密代扣上传的附加信息 base64_qrcode string Y base64后的乘车码信息 out_order_no string Y 外部传的单号 2、返回参数 参数名称 类型 必选 备注 errcode int Y 0为成功 errmsg string N 错误信息 nonce_str string Y 原样带回 3、示例 请求： {"appid":"test","mch_id":"123456","nonce_str":"abcdefg","encrypted_data":"jfiwajeofjiefef","iv":"afweifwefe"} encrypted_data解密后为: { "out_user_id":"xxx", "openid":"1234", "bank_type":"LQT", "total_fee":123, "transaction_id":"12312312",...

用户签约状态查询 业主方查询用户签约状态接口。 1、请求参数 参数名称 类型 必选 备注 openid string N 用户openid(优先使用) cardid string N 业主方的用户标识，注册接口返回 2、返回参数 参数名称 类型 必选 备注 errcode int32 Y 返回码 errmsg string N 返回信息 status int Y 用户签约状态 0-已签约 1-未签约 3、示例代码 请求： {"openid":"afefawefwef","cardid":"123"} 返回: {"errcode":0,"errmsg":"ok","status":0}