服务平台 API

API 均在 wx.serviceMarket 对象下。

invokeService

调用服务提供商提供的 API

入参

接收一个对象，对象下有如下定义的字段：

字段名类型必填默认值说明
servicestring是服务提供商 ID
apistring是是服务 API 名
dataObject否传递给服务 API 的 JSON 数据

返回值

返回一个 Promise，如调用失败，则 reject 一个 Error 对象，如调用成功，则 resolve 结果为如下定义的对象：

字段名类型必填默认值说明
dataObject是服务 API 的返回结果

示例代码 1: OCR

从手机选择图片后，调用 OCR 服务。OCR 服务要求调用方传图片，接收图片的方式是图片 URL。OCR 服务要求调用方的 data 结构如下：

字段名类型必填默认值说明
img_urlstring是图片 URL
data_typenumber是固定为 3，表示 URL 形式的图片
ocr_typenumber是OCR 类型，1 为身份证识别

OCR 的接口需要传入图片 URL，如果需要将手机本地选择的图片上传转换成 URL，既可以用任意的存储服务和自建的存储服务，也可以使用云开发的云文件存储服务（有免费配额），以下分别给出对应的示例。

首先假设有自己的存储服务，示例代码如下：

  1. // 选择图片
  2. wx.chooseImage({
  3.   count: 1,
  4.   success: async function(res) {
  5.     try {
  7.       // 将选择到的图片上传到自己的存储空间，假设获取得到的链接为 http://aaa.bbb.ccc/xxx.jpg
  9.       const invokeRes = await wx.serviceMarket.invokeService({
  10.         service: 'wx79ac3de8be320b71',
  11.         api: 'ocr',
  12.         data: {
  13.           img_url: 'http://aaa.bbb.ccc/xxx.jpg',
  14.           data_type: 3,
  15.           ocr_type: 1
  16.         },
  17.       })
  19.       console.log('invokeService success', invokeRes)
  20.       wx.showModal({
  21.         title: 'success',
  22.         content: JSON.stringify(invokeRes),
  23.       })
  24.     } catch (err) {
  25.       console.error('invokeService fail', JSON.stringify(err))
  26.       wx.showModal({
  27.         title: 'fail',
  28.         content: JSON.stringify(err),
  29.       })
  30.     }
  31.   },
  32.   fail: function(res) {},
  33.   complete: function(res) {},
  34. })

接着以使用云开发为例：

首先需要开通云开发，完成后如下方式上传图片然后调用 OCR 服务：

  1. wx.cloud.init({
  2.   env: '你的云环境ID',
  3. })
  5. // 选择图片
  6. wx.chooseImage({
  7.   count: 1,
  8.   success: async function(res) {
  9.     try {
  10.       const uploadResult = await wx.cloud.uploadFile({
  11.         filePath: res.tempFilePaths[0],
  12.         cloudPath: `tmp/${Date.now()}`,
  13.       })
  15.       const { fileList } = await wx.cloud.getTempFileURL({
  16.         fileList: [uploadResult.fileID],
  17.       })
  19.       const invokeRes = await wx.serviceMarket.invokeService({
  20.         service: 'wx79ac3de8be320b71',
  21.         api: 'ocr',
  22.         data: {
  23.           img_url: fileList[0].tempFileURL,
  24.           data_type: 3,
  25.           ocr_type: 1
  26.         },
  27.       })
  29.       await wx.cloud.deleteFile({
  30.         fileList: [fileID],
  31.       })
  33.       console.log('invokeService success', invokeRes)
  34.       wx.showModal({
  35.         title: 'success',
  36.         content: JSON.stringify(invokeRes),
  37.       })
  38.     } catch (err) {
  39.       console.error('invokeService fail', JSON.stringify(err))
  40.       wx.showModal({
  41.         title: 'fail',
  42.         content: JSON.stringify(err),
  43.       })
  44.     }
  45.   },
  46.   fail: function(res) {},
  47.   complete: function(res) {},
  48. })

示例代码 2: 不需上传的情况

有些服务不需要传递 URL 或大数据，可以直接 JSON 调用，以下任意举例：

  1. // 选择图片
  2. wx.chooseImage({
  3.   count: 1,
  4.   success: function(res) {
  5.     // 调用 OCR 服务
  6.     wx.serviceMarket.invokeService({
  7.       service: 'some_service_id',
  8.       api: 'test',
  9.       data: {
  10.         type: 'x',
  11.         name: 'y',
  12.       },
  13.     }).then(res => {
  14.       console.log('invokeService success', res)
  15.     }).catch(err => {
  16.       console.error('invokeService fail', err)
  17.     })
  18.   },
  19.   fail: function(err) {
  20.     console.error(err)
  21.   },
  22. })