OCR

mtl支持版本6.0.11及以上

OCR 接口调用APILINK 的API，需要用户自己到平台上申请 appCode。

发票

scanInvoice

打开相机拍摄发票并返回识别结果（APILINK所选择服务名称：增值税发票识别OCRV2）
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode

示例

mtl.scanInvoice({
  appCode: "",
  success: function(res) {
    var result = res.data; // 返回识别结果
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

返回数据格式

{
  "发票代码": "032001500XXX",
  "发票号码": "25272XXX",
  "开票日期": "2017年XX月XX日",
  "校验码": "15922733756000XXXXXX",
  "发票金额": "XXX.00",
  "发票税额": "XXX.43",
  "不含税金额": "XXX.57",
  "受票方名称": "XXX",
  "受票方税号": "XXXX",
  "受票方地址、电话": "XXX",
  "受票方开户行、账号": "XXX",
  "销售方名称": "XXX",
  "销售方税号": "913201043023368XXX",
  "销售方地址、电话": "XXX",
  "销售方开户行、账号": "XXX"
}

recognizeInvoice

配合[图像接口](https://mtldev.yuque.com/docs/share/3427a90b-57f0-4f77-b556-2575c3a07a44?# 《多媒体》)使用，直接识别已选择(或下载)的图片。 
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode
image string 是 图片，支持 localId/base64

示例

mtl.recognizeInvoice({
  appCode: "",
  image: "",
  success: function(res) {
    var result = res.data; // 返回识别结果，同 scanInvoice
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

身份证

scanIDCard

打开相机扫描身份证并返回识别结果 （APILINK所选择服务名称：身份证OCRV2）
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode
side string 是 身份证正反面；face/back

示例

mtl.scanIDCard({
  appCode: "",
  side: "face",
  success: function(res) {
    var result = res.data;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

返回的数据格式

{
  address: "浙江省杭州市余杭区文一西路969号", // 地址信息
  config_str: '{"side":"face"}', // 配置信息，同输入configure
  face_rect: {
    // 人脸位置
    angle: -90, // angle 表示矩形顺时针旋转的度数
    center: {
      // center 表示人脸矩形中心坐标
      x: 952,
      y: 325.5
    },
    size: {
      // size表示人脸矩形长宽
      height: 181.99,
      width: 164.99
    }
  },
  face_rect_vertices: [
    // 人脸位置，四个顶点表示
    {
      x: 1024.6600341796875,
      y: 336.629638671875
    },
    {
      x: 906.66107177734375,
      y: 336.14801025390625
    },
    {
      x: 907.1590576171875,
      y: 214.1490478515625
    },
    {
      x: 1025.157958984375,
      y: 214.63067626953125
    }
  ],
  name: "张三", // 姓名
  nationality: "汉", // 民族
  num: "1234567890", // 身份证号
  sex: "男", // 性别
  birth: "20000101", // 出生日期
  nationality: "汉", // 民族
  success: true // 识别结果，true表示成功，false表示失败
};

{
  config_str: '{"side":"back"}', // 配置信息，同输入configure
  start_date: "19700101", // 有效期起始时间
  end_date: "19800101", // 有效期结束时间
  issue: "杭州市公安局", // 签发机关
  success: true // 识别结果，true表示成功，false表示失败
}

recognizeIDCard

配合[图像接口](https://mtldev.yuque.com/docs/share/3427a90b-57f0-4f77-b556-2575c3a07a44?# 《多媒体》)使用，直接识别已选择(或下载)的图片。 
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode
side string 是 身份证正反面；face/back
image string 是 图片，支持 localId/base64

示例

mtl.recognizeIDCard({
  appCode: "",
  image: "",
  side: "",
  success: function(res) {
    var result = res.data; // 返回识别结果，同上
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

银行卡

scanBankCard

打开相机扫描银行卡并返回识别结果 （APILINK所选择服务名称：银行卡识别OCRV2）
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode

示例

mtl.scanBankCard({
  appCode: "",
  success: function(res) {
    var result = res.data; // 返回识别结果
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

返回数据格式

{
  "card_num" : "1234567890123456",		// 银行卡卡号，可能为空
  "request_id" : "2017...b865d2973",	// 请求唯一标识，用于错误追踪
  "success" : true      							// 识别成功与否 true/false
}

recognizeBankCard

配合[图像接口](https://mtldev.yuque.com/docs/share/3427a90b-57f0-4f77-b556-2575c3a07a44?# 《多媒体》)使用，直接识别已选择(或下载)的图片。 
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
appCode string 是 apiLink申请的 appcode
image string 是 图片，支持 localId/base64

示例

mtl.recognizeBankCard({
  appCode: "",
  image: "",
  success: function(res) {
    var result = res.data; // 返回识别结果，同上
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});
是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/8