微信小程序 OCR·businessLicense

2022-05-12 15:16 更新

ocr.businessLicense

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。
本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

本接口提供基于小程序的營業(yè)執(zhí)照 OCR 識別

調(diào)用方式:

  • HTTPS 調(diào)用
  • 云調(diào)用

HTTPS 調(diào)用

請求地址

POST https://api.weixin.qq.com/cv/ocr/bizlicense?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
img_url string 要檢測的圖片 url,傳這個則不用傳 img 參數(shù)。
img FormData form-data 中媒體文件標(biāo)識,有filename、filelength、content-type等信息,傳這個則不用傳 img_url。

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errcode string 錯誤碼
errmsg string 錯誤信息
reg_num string 注冊號
serial string 編號
legal_representative string 法定代表人姓名
enterprise_name string 企業(yè)名稱
type_of_organization string 組成形式
address string 經(jīng)營場所/企業(yè)住所
type_of_enterprise string 公司類型
business_scope string 經(jīng)營范圍
registered_capital string 注冊資本
paid_in_capital string 實(shí)收資本
valid_period string 營業(yè)期限
registered_date string 注冊日期/成立日期
cert_position string 營業(yè)執(zhí)照位置
img_size string 圖片大小

使用說明

接口限制 內(nèi)測期間已認(rèn)證的訂閱號、服務(wù)號、企業(yè)號、小程序可直接調(diào)用,次數(shù)限制為500次/天。

使用 Tips 此接口為后臺接口,可基于自有業(yè)務(wù)承載情況,搭配小程序的拍照、相冊選照等一起使用,即可完成身份證照片的采集、上傳、識別、信息返回等流程,用于需要基于身份證、銀行卡等實(shí)體卡或證,采集照片或文字信息等的業(yè)務(wù)場景。

圖片說明 文件大小限制:小于2M

返回字段僅包含當(dāng)前營業(yè)執(zhí)照圖片中存在的字段,若對應(yīng)字段不存在則不返回

拍攝圖片樣例

請求數(shù)據(jù)示例

示例1:

curl https://api.weixin.qq.com/cv/ocr/bizlicense?img_url= ENCODE_URL&access_token=ACCESS_TOCKEN

示例2:

curl -F ‘img=@test.jpg’“https://api.weixin.qq.com/cv/ocr/bizlicense?access_token=ACCESS_TOCKEN”

返回數(shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "reg_num": "123123",                                                     //注冊號
    "serial": "123123",                                                      //編號
    "legal_representative": "張三",                                          //法定代表人姓名
    "enterprise_name": "XX飲食店",                                           //企業(yè)名稱
    "type_of_organization": "個人經(jīng)營",                                      //組成形式
    "address": "XX市XX區(qū)XX路XX號",                                           //經(jīng)營場所/企業(yè)住所
    "type_of_enterprise": "xxx",                                             //公司類型
    "business_scope": "中型餐館(不含涼菜、不含裱花蛋糕,不含生食海產(chǎn)品)。",  //經(jīng)營范圍
    "registered_capital": "200萬",                                           //注冊資本
    "paid_in_capital": "200萬",                                              //實(shí)收資本
    "valid_period": "2019年1月1日",                                          //營業(yè)期限
    "registered_date": "2018年1月1日",                                       //注冊日期/成立日期
    "cert_position": {                                                       //營業(yè)執(zhí)照位置
        "pos": {
            "left_top": {
                "x": 155,
                "y": 191
            },
            "right_top": {
                "x": 725,
                "y": 157
            },
            "right_bottom": {
                "x": 743,
                "y": 512
            },
            "left_bottom": {
                "x": 164,
                "y": 525
            }
        }
    },
    "img_size": {                                                            //圖片大小
        "w": 966,
        "h": 728
    }
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力,需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.ocr.businessLicense
需在 config.json 中配置 ocr.businessLicense API 的權(quán)限,詳情

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
imgUrl string 要檢測的圖片 url,傳這個則不用傳 img 參數(shù)。
img FormData form-data 中媒體文件標(biāo)識,有filename、filelength、content-type等信息,傳這個則不用傳 img_url。

img 的結(jié)構(gòu)

屬性 類型 默認(rèn)值 必填 說明
contentType string 數(shù)據(jù)類型,傳入 MIME Type
value Buffer 文件 Buffer

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errCode string 錯誤碼
errMsg string 錯誤信息
regNum string 注冊號
serial string 編號
legalRepresentative string 法定代表人姓名
enterpriseName string 企業(yè)名稱
typeOfOrganization string 組成形式
address string 經(jīng)營場所/企業(yè)住所
typeOfEnterprise string 公司類型
businessScope string 經(jīng)營范圍
registeredCapital string 注冊資本
paidInCapital string 實(shí)收資本
validPeriod string 營業(yè)期限
registeredDate string 注冊日期/成立日期
certPosition string 營業(yè)執(zhí)照位置
imgSize string 圖片大小

異常

Object

拋出的異常

屬性 類型 說明
errCode string 錯誤碼
errMsg string 錯誤信息

errCode 的合法值

說明 最低版本

使用說明

接口限制 內(nèi)測期間已認(rèn)證的訂閱號、服務(wù)號、企業(yè)號、小程序可直接調(diào)用,次數(shù)限制為500次/天。

使用 Tips 此接口為后臺接口,可基于自有業(yè)務(wù)承載情況,搭配小程序的拍照、相冊選照等一起使用,即可完成身份證照片的采集、上傳、識別、信息返回等流程,用于需要基于身份證、銀行卡等實(shí)體卡或證,采集照片或文字信息等的業(yè)務(wù)場景。

圖片說明 文件大小限制:小于2M

返回字段僅包含當(dāng)前營業(yè)執(zhí)照圖片中存在的字段,若對應(yīng)字段不存在則不返回

拍攝圖片樣例

請求數(shù)據(jù)示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.ocr.businessLicense({
        imgUrl: 'ENCODE_URL'
      })
    return result
  } catch (err) {
    return err
  }
}

// cloud = require('wx-server-sdk')
// ...
// 方法返回 Promise
cloud.openapi.ocr.businessLicense({
  img: {
    contentType: 'image/png',
    value: Buffer
  }
})

返回數(shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "reg_num": "123123",                                                     //注冊號
    "serial": "123123",                                                      //編號
    "legal_representative": "張三",                                          //法定代表人姓名
    "enterprise_name": "XX飲食店",                                           //企業(yè)名稱
    "type_of_organization": "個人經(jīng)營",                                      //組成形式
    "address": "XX市XX區(qū)XX路XX號",                                           //經(jīng)營場所/企業(yè)住所
    "type_of_enterprise": "xxx",                                             //公司類型
    "business_scope": "中型餐館(不含涼菜、不含裱花蛋糕,不含生食海產(chǎn)品)。",  //經(jīng)營范圍
    "registered_capital": "200萬",                                           //注冊資本
    "paid_in_capital": "200萬",                                              //實(shí)收資本
    "valid_period": "2019年1月1日",                                          //營業(yè)期限
    "registered_date": "2018年1月1日",                                       //注冊日期/成立日期
    "cert_position": {                                                       //營業(yè)執(zhí)照位置
        "pos": {
            "left_top": {
                "x": 155,
                "y": 191
            },
            "right_top": {
                "x": 725,
                "y": 157
            },
            "right_bottom": {
                "x": 743,
                "y": 512
            },
            "left_bottom": {
                "x": 164,
                "y": 525
            }
        }
    },
    "img_size": {                                                            //圖片大小
        "w": 966,
        "h": 728
    }
}


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號