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

ocr.bankcard 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 本接口提供基于小程序的银行卡 OCR 识别 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cv/ocr/bankcard?type=MODE&img_url=ENCODE_URL&access_token=ACCESS_TOCKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 img_url string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 返回值 Object 返回的 JSON 数据包 属性 类型 说明 errcode string 错误码 errmsg string 错误信息 number string 银行卡号 使用说明 接口限制 内测期间已认证的订阅号、服务号、企业号、小程序可直接调用，次数限制为500次/天。 使用 Tips 此接口为后台接口，可基于自有业务承载情况，搭配小程序的拍照、相册选照等一起使用，即可完成身份证照片的采集、上传、识别、信息返回等流程，用于需要基于身份证、银行卡等实体卡或证，采集照片或文字信息等的业务场景。 图片说明 文件大小限制：小于2M 图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别。type 有两种类型 拍摄图片样例 请求数据示例 示例1： curl "https://api.weixin.qq.com/cv/ocr/bankcard?img_url= ENCODE_URL&access_token=ACCESS_TOCKEN" 示例2： curl -F ‘img=@test.jpg’ “https://api.weixin.qq.com/cv/ocr/bankcard?access_token=ACCESS_TOCKEN” 返回数据示例 { "errcode": "0", "errmsg": "ok", "id": "622213XXXXXXXXX" } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.ocr.bankcard 需在 config.json 中配置 ocr.bankcard API 的权限，详情 请求参数 属性 类型 默认值 必填 说明 imgUrl string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 img 的结构 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入...

img.superresolution 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 本接口提供基于小程序的图片高清化能力。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cv/img/superresolution?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 img_url string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 返回值 Object 返回的 JSON 数据包 属性 类型 说明 errcode string 错误码 errmsg string 错误信息 使用说明 说明 文件大小限制：小于2M 图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别。 目前支持将图片超分辨率高清化2倍，即生成图片分辨率为原图2倍大小 请求数据示例 示例1： curl 'https://api.weixin.qq.com/cv/img/superresolution?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN' 示例2： curl -F 'img=@test.jpg' 'https://api.weixin.qq.com/cv/img/superresolution?access_token=ACCESS_TOCKEN' 返回数据示例 { "errcode": 0, "errmsg": "ok", "media_id": "6WXsIXkG7lXuDLspD9xfm5dsvHzb0EFl0li6ySxi92ap8Vl3zZoD9DpOyNudeJGB" } 说明 返回的media_id有效期为3天，期间可以通过“获取临时素材”接口获取图片二进制，示例： curl "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" -o "output.jpg" 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.img.superresolution 需在 config.json 中配置 img.superresolution API 的权限，详情 请求参数 属性 类型 默认值 必填 说明 imgUrl string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 img 的结构 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入 MIME Type value Buffer...

img.scanQRCode 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 本接口提供基于小程序的条码/二维码识别的API。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 img_url string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 返回值 Object 返回的 JSON 数据包 属性 类型 说明 errcode string 错误码 errmsg string 错误信息 使用说明 图片说明 文件大小限制：小于2M 二维码说明 支持条码、二维码、DataMatrix和PDF417的识别。 二维码、DataMatrix会返回位置坐标，条码和PDF417暂不返回位置坐标。 请求数据示例 示例1： curl https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN 示例2： curl -F 'img=@test.jpg' 'https://api.weixin.qq.com/cv/img/qrcode?access_token=ACCESS_TOCKEN' 返回数据示例 { "errcode": 0, "errmsg": "ok", "code_results": [ { "type_name": "QR_CODE", "data": "http://www.qq.com", "pos": { "left_top": { "x": 585, "y": 378 }, "right_top": { "x": 828, "y": 378 }, "right_bottom": { "x": 828, "y": 618 }, "left_bottom": { "x": 585, "y": 618 } } }, { "type_name": "QR_CODE", "data": "https://mp.weixin.qq.com", "pos": { "left_top": { "x":...

img.aiCrop 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 本接口提供基于小程序的图片智能裁剪能力。 调用方式： HTTPS 调用 云调用 HTTPS 调用 请求地址 POST https://api.weixin.qq.com/cv/img/aicrop?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN 请求参数 属性 类型 默认值 必填 说明 access_token string 是 接口调用凭证 img_url string 是 要检测的图片 url，传这个则不用传 img 参数。 img FormData 是 form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 返回值 Object 返回的 JSON 数据包 属性 类型 说明 errcode string 错误码 errmsg string 错误信息 使用说明 说明 文件大小限制：小于2M 图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别。 ratios参数为可选，如果为空，则算法自动裁剪最佳宽高比；如果提供多个宽高比，请以英文逗号“,”分隔，最多支持5个宽高比 请求数据示例 示例1： curl -F 'ratios=1,2.35' "http://api.weixin.qq.com/cv/img/aicrop?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN" 示例2： curl -F 'img=@test.jpg' -F 'ratios=1,2.35' 'http://api.weixin.qq.com/cv/img/aicrop?access_token=ACCESS_TOCKEN' 返回数据示例 { "errcode": 0, "errmsg": "ok", "results": [ //智能裁剪结果 { "crop_left": 112, "crop_top": 0, "crop_right": 839, "crop_bottom": 727 }, { "crop_left": 0, "crop_top": 205, "crop_right": 965, "crop_bottom": 615 } ], "img_size": { //图片大小 "w": 966, "h": 728 } } 云调用 云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。 接口方法 openapi.img.aiCrop 需在 config.json 中配置 img.aiCrop API 的权限，详情 请求参数 属性 类型 默认值 必填 说明...

ad.getUserActionSetReports 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 广告数据源报表查询 说明 微信广告文档：https://ad.weixin.qq.com/guide/457 对应接口 https://api.weixin.qq.com/marketing/user_action_set_reports/get 云调用使用说明 外链文档中可能只有 HTTP 形式的定义，对云调用方式，调用时参数与 HTTP 需求的参数一致，但是无需传入 access_token，同时所有的参数无论 get/post 都只需作为接口参数 JS 对象中的一个字段传入即可。 而对于 FormData 的请求，如果一个参数的类型是 Buffer，则其字段应传入有如下字段的对象： 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入 MIME Type value Buffer 是 文件 Buffer 示例 假设外链文档要求是 POST 方法，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … yyy number JSON body … 则调用示例如下： cloud.openapi.ad.getUserActionSetReports({ xxx: '字符串', yyy: 100, }) 假设外链文档要求是 POST FormData，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … media buffer FormData 图片 buffer 则调用示例如下： cloud.openapi.ad.getUserActionSetReports({ xxx: '字符串', media: { contentType: 'image/png', value: Buffer }, })

ad.addUserAction 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 回传广告数据 说明 微信广告文档：https://ad.weixin.qq.com/guide/457 对应接口 https://api.weixin.qq.com/marketing/user_actions/add 云调用使用说明 外链文档中可能只有 HTTP 形式的定义，对云调用方式，调用时参数与 HTTP 需求的参数一致，但是无需传入 access_token，同时所有的参数无论 get/post 都只需作为接口参数 JS 对象中的一个字段传入即可。 而对于 FormData 的请求，如果一个参数的类型是 Buffer，则其字段应传入有如下字段的对象： 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入 MIME Type value Buffer 是 文件 Buffer 示例 假设外链文档要求是 POST 方法，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … yyy number JSON body … 则调用示例如下： cloud.openapi.ad.addUserAction({ xxx: '字符串', yyy: 100, }) 假设外链文档要求是 POST FormData，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … media buffer FormData 图片 buffer 则调用示例如下： cloud.openapi.ad.addUserAction({ xxx: '字符串', media: { contentType: 'image/png', value: Buffer }, })

ad.addUserActionSet 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 广告创建数据源 说明 微信广告文档：https://ad.weixin.qq.com/guide/457 对应接口 https://api.weixin.qq.com/marketing/user_action_sets/add 云调用使用说明 外链文档中可能只有 HTTP 形式的定义，对云调用方式，调用时参数与 HTTP 需求的参数一致，但是无需传入 access_token，同时所有的参数无论 get/post 都只需作为接口参数 JS 对象中的一个字段传入即可。 而对于 FormData 的请求，如果一个参数的类型是 Buffer，则其字段应传入有如下字段的对象： 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入 MIME Type value Buffer 是 文件 Buffer 示例 假设外链文档要求是 POST 方法，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … yyy number JSON body … 则调用示例如下： cloud.openapi.ad.addUserActionSet({ xxx: '字符串', yyy: 100, }) 假设外链文档要求是 POST FormData，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … media buffer FormData 图片 buffer 则调用示例如下： cloud.openapi.ad.addUserActionSet({ xxx: '字符串', media: { contentType: 'image/png', value: Buffer }, })

ad.getUserActionSets 本接口应在服务器端调用，详细说明参见服务端API。 本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载） wx-server-sdk >= 0.4.0 广告数据源查询 说明 微信广告文档：https://ad.weixin.qq.com/guide/457 对应接口 https://api.weixin.qq.com/marketing/user_action_sets/get 云调用使用说明 外链文档中可能只有 HTTP 形式的定义，对云调用方式，调用时参数与 HTTP 需求的参数一致，但是无需传入 access_token，同时所有的参数无论 get/post 都只需作为接口参数 JS 对象中的一个字段传入即可。 而对于 FormData 的请求，如果一个参数的类型是 Buffer，则其字段应传入有如下字段的对象： 属性 类型 默认值 必填 说明 contentType string 是 数据类型，传入 MIME Type value Buffer 是 文件 Buffer 示例 假设外链文档要求是 POST 方法，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … yyy number JSON body … 则调用示例如下： cloud.openapi.ad.getUserActionSets({ xxx: '字符串', yyy: 100, }) 假设外链文档要求是 POST FormData，要求传入如下参数 属性 类型 位置 说明 xxx string URL 参数 … media buffer FormData 图片 buffer 则调用示例如下： cloud.openapi.ad.getUserActionSets({ xxx: '字符串', media: { contentType: 'image/png', value: Buffer }, })

NfcV 基础库 2.11.2 开始支持，低版本需做兼容处理。 NfcV 标签 方法： NfcV.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcV.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcV.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 length number 最大传输长度 NfcV.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否...

NfcF 基础库 2.11.2 开始支持，低版本需做兼容处理。 NfcF 标签 方法： NfcF.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcF.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcF.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 length number 最大传输长度 NfcF.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否...