xfaceprint

Documentation

Overview

百度人脸识别/人脸认证SDK

Index

• func GetAccessToken() string
• func GetResultSimple(verify_token string) (string, error)
• func GetVerifyToken() string
• func Regedit(c *Config)
• func SubmitApp(id_card_name, id_card_number, image_type, image_data string) (float64, error)
• func SubmitInfo(v_token, id_name, id_no string, c_type uint) error
• func SwitchPlanId(plan_id string)
• type Config
• type IdCardSubmitStruct
  • func GetSubmitInfo(v_token, suc_url, err_url string) *IdCardSubmitStruct
  • func IdcardSubmit(id_name, id_no string, c_type uint, suc_url, err_url string) (*IdCardSubmitStruct, error)
• type ResultDetailResult
  • func GetResultDetail(verify_token string) (*ResultDetailResult, error)
• type ResultDetailResultIdcardConfirm
• type ResultDetailResultIdcardImages
• type ResultDetailResultIdcardOcrResult
• type ResultDetailResultVerifyResult

Functions

func GetAccessToken

func GetAccessToken() string

获取百度AI中心的token标识

func GetResultSimple

func GetResultSimple(verify_token string) (string, error)

获取认证图片

verify_token	识别token

func GetVerifyToken

func GetVerifyToken() string

获取百度鉴权的verify_token

func Regedit

func Regedit(c *Config)

配置项注入

func SubmitApp

func SubmitApp(id_card_name, id_card_number, image_type, image_data string) (float64, error)

APP端直接上传图片到百度进行识别

id_card_name	姓名
id_card_number	身份证号
image_type		图片类型，支持：BASE64、URL、FACE_TOKEN
image_data		图片值

func SubmitInfo

func SubmitInfo(v_token, id_name, id_no string, c_type uint) error

提交用户个人资料信息

v_token	批次Token/批次ID
id_name	姓名
id_no	身份证号
c_type	身份证类型 0-大陆居民二代身份证 4-港澳台居民居住证

func SwitchPlanId

func SwitchPlanId(plan_id string)

切换plan_id

plan_id	方案的id信息，请在人脸实名认证控制台查看创建的H5方案的方案ID信息

Types

type Config

type Config struct {
	Domain    string // 人脸识别接口域名
	AppId     string // 百度开发者平台的AppId
	AppKey    string // 百度开发者平台的AK
	SecretKey string // 百度开发者平台的密钥信息
	PlanId    string // 获取鉴权ID
}

百度人脸识别配置项

type IdCardSubmitStruct

type IdCardSubmitStruct struct {
	SuccessUrl  string `json:"success_url" form:"success_url"`   // 成功的回跳地址
	ErrorUrl    string `json:"error_url" form:"error_url"`       // 失败的回跳地址
	H5Url       string `json:"h5_url" form:"h5_url"`             // 认证H5地址
	VerifyToken string `json:"verify_token" form:"verify_token"` // 请求批次
}

func GetSubmitInfo

func GetSubmitInfo(v_token, suc_url, err_url string) *IdCardSubmitStruct

拼接H5连接信息

v_token	批次Token/批次ID
suc_url	成功后的跳转地址，会自动追加&verify_token=xxxxx，所以若地址为绝对地址时请追加?
err_url	成功后的跳转地址，会自动追加&verify_token=xxxxx，所以若地址为绝对地址时请追加?

func IdcardSubmit

func IdcardSubmit(id_name, id_no string, c_type uint, suc_url, err_url string) (*IdCardSubmitStruct, error)

用户信息提交接口

id_name	姓名
id_no	身份证号
c_type	身份证类型 0-大陆居民二代身份证 4-港澳台居民居住证
suc_url	成功后的跳转地址，会自动追加&verify_token=xxxxx，所以若地址为绝对地址时请追加?
err_url	成功后的跳转地址，会自动追加&verify_token=xxxxx，所以若地址为绝对地址时请追加?

type ResultDetailResult

type ResultDetailResult struct {
	VerifyResult    ResultDetailResultVerifyResult    `json:"verify_result" form:"verify_result"`         // 认证返还信息
	IdcardOcrResult ResultDetailResultIdcardOcrResult `json:"idcard_ocr_result" form:"idcard_ocr_result"` // 返回采集的身份证信息 当人脸实名认证控制台设置为使用OCR识别时返回此参数信息
	IdcardImages    ResultDetailResultIdcardImages    `json:"idcard_images" form:"idcard_images"`         // 返回采集的身份证图片信息 当人脸实名认证控制台设置为使用OCR识别时返回此参数信息
	IdcardConfirm   ResultDetailResultIdcardConfirm   `json:"idcard_confirm" form:"idcard_confirm"`       // 用户二次确认的身份证信息
}

func GetResultDetail

func GetResultDetail(verify_token string) (*ResultDetailResult, error)

获取认证结果

verify_token	识别token

type ResultDetailResultIdcardConfirm

type ResultDetailResultIdcardConfirm struct {
	IdcardNumber string `json:"idcard_number" form:"idcard_number"` // 身份证号
	Name         string `json:"name" form:"name"`                   // 姓名
}

type ResultDetailResultIdcardImages

type ResultDetailResultIdcardImages struct {
	FrontBase64 string `json:"front_base64" form:"front_base64"` // 身份证图片的正面信息
	BackBase64  string `json:"back_base64" form:"back_base64"`   // 身份证图片的反面信息 当人脸实名认证控制台设置为使用OCR识别且为国徽面+人像面时返回此参数信息
}

type ResultDetailResultIdcardOcrResult

type ResultDetailResultIdcardOcrResult struct {
	IssueAuthority string `json:"issue_authority" form:"issue_authority"` // 身份证签发机关
	Address        string `json:"address" form:"address"`                 // 地址
	Nation         string `json:"nation" form:"nation"`                   // 民族
	ExpireTime     string `json:"expire_time" form:"expire_time"`         // 身份证失效日期
	Name           string `json:"name" form:"name"`                       // 姓名
	IssueTime      string `json:"issue_time" form:"issue_time"`           // 身份证生效日期
	IdCardNumber   string `json:"id_card_number" form:"id_card_number"`   // 身份证号
	Birthday       string `json:"birthday" form:"birthday"`               // 生日
	Gender         string `json:"gender" form:"gender"`                   // 性别
}

type ResultDetailResultVerifyResult

type ResultDetailResultVerifyResult struct {
	LivenessScore json.Number `json:"liveness_score" form:"liveness_score"` // 活体检测分数：在线图片/动作活体：活体验证通过时返回活体分数，不通过则返回0。炫瞳活体：活体通过/不通过均会返回0
	Spoofing      json.Number `json:"spoofing" form:"spoofing"`             // 合成图分数 若未进行合成图检测，则返回0 若进行活体检测，则返回合成图检测分值
	Score         json.Number `json:"score" form:"score"`                   // 人脸实名认证
}