本文介紹了金融級實人認證純服務端API的Node.js SDK調用示例。
SDK使用說明
如果需要其他語言的SDK示例代碼,您可以通過OpenAPI 開發者門戶在線調試工具調試API接口,該工具會自動生成相應API的SDK調用示例代碼。您可以單擊以下接口鏈接進行調試:
前提條件
需要使用的Node.js為8.0及以上版本。
已添加認證場景,并獲取對應的場景ID。具體操作,請參見添加認證場景。
安裝SDK
關于Node.js SDK源代碼,請參見Node.js SDK。
建議您使用npm管理依賴包:
npm install @alicloud/tea-util
npm install @alicloud/openapi-client
npm install @alicloud/cloudauth20190307@2.0.3
npm install @alicloud/credentials
說明
Credentials工具配置方法,請參見身份驗證配置。
照片實人認證調用示例
關于參數的具體描述,請參見照片實人認證。
const Config = require("@alicloud/openapi-client");
const CloudAuth = require("@alicloud/cloudauth20190307");
const CloudAuthClient = CloudAuth.default;
const {RuntimeOptions} = require("@alicloud/tea-util");
const { default: Credential } = require('@alicloud/credentials');
function createClient(endpoint) {
// 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過阿里云Credentials工具從環境變量中讀取AccessKey,來實現API訪問的身份驗證。
const cred = new Credential();
const config = new Config.Config({
credential: cred,
// 設置Endpoint。
endpoint: endpoint,
// 設置HTTP代理。
// httpProxy: "http://xxx.xxx.xxx.xxx:9999",
// 設置HTTPS代理。
// httpsProxy: "https://username:password@xxx.xxx.xxx.xxx:9999",
});
return new CloudAuthClient(config);
}
async function contrastFaceVerify(endpoint, request) {
const client = createClient(endpoint);
// 創建RuntimeObject實例并設置運行參數。
const runtime = new RuntimeOptions([]);
runtime.readTimeout=10000;
runtime.connectTimeout=10000;
return await client.contrastFaceVerifyWithOptions(request, runtime);
}
async function contrastFaceVerifyAutoRoute(request) {
const endpoints = [
"cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com"
];
for (const endpoint of endpoints) {
try {
const response = await contrastFaceVerify(endpoint, request);
if (response.statusCode === 500) {
continue;
}
if(response.body !== null){
if(response.body.code === "500"){
continue;
}
}
return response;
} catch (err) {
console.log(err);
continue;
}
}
return null;
}
async function main(){
// 通過以下代碼創建API請求并設置參數。
const request = new CloudAuth.ContrastFaceVerifyRequest({
// 請輸入場景ID。
sceneId: 0,
// 設置商戶請求的唯一標識。
outerOrderNo: "xxx",
// 要接入的認證方案。
productCode: "ID_MIN",
// 模式。
model: "NO_LIVENESS",
// 固定值。
certType: "IDENTITY_CARD",
certName: "張三",
certNo: "xxx",
// mobile: "130xxxxxxxx",
// 請在以下四種方式中選擇其一。
// 1.人臉圖片的Base64編碼。
// 2.已授權OSS空間的Bucket名和已授權OSS空間的文件名。
// 3.人臉圖片的HTTPS或HTTP地址。
// 4.已通過智能核身得到的CertifyId,認證時的圖片作為比對圖片。
// 方式一:人臉圖片的Base64編碼。
// faceContrastPicture: "/9j/4AAQSkZJRgABAQAASxxxxxxx",
// 方式二:已授權OSS空間的Bucket名和已授權OSS空間的文件名。
// ossBucketName: "cn-shanghai-aliyun-cloudauth-xxxxx",
// ossObjectName: "verify/xxxxx/xxxxxx.jpeg",
//方式三:人臉圖片的HTTPS或HTTP地址。
faceContrastPictureUrl: "https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg",
// 方式四:已通過智能核身得到的CertifyId,認證時的圖片作為比對圖片。
// certifyId: "0bfa7c493f850e5178b9f8613634c9xx",
// ip: "114.xxx.xxx.xxx",
// userId: "12345xxxx",
// deviceToken: "xxxxxxx",
// 如需開啟個人信息加密傳輸。
// encryptType: "SM2",
// certName: "BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==",
// certNo: "BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg=="
});
// 推薦,支持服務路由。
const response = await contrastFaceVerifyAutoRoute(request);
// 不支持服務自動路由。
// const response = await contrastFaceVerify("cloudauth.cn-shanghai.aliyuncs.com", request);
if (response){
console.log(response.body.requestId);
console.log(response.body.code);
console.log(response.body.message);
console.log(response.body.resultObject.certifyId);
}
}
main().then(function (response) {});
視頻實人認證調用示例
支持OSS對象存儲方式和本地文件兩種方式。關于參數的具體描述,請參見視頻實人認證。
使用本地文件的方式(推薦)
const Config = require("@alicloud/openapi-client");
const CloudAuth = require("@alicloud/cloudauth20190307");
const CloudAuthClient = CloudAuth.default;
const {RuntimeOptions} = require("@alicloud/tea-util");
const fs = require("fs");
const { default: Credential } = require('@alicloud/credentials');
function createClient(endpoint) {
// 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過阿里云Credentials工具從環境變量中讀取AccessKey,來實現API訪問的身份驗證。
const cred = new Credential();
const config = new Config.Config({
credential: cred,
// 設置Endpoint。
endpoint: endpoint,
// 設置HTTP代理。
// httpProxy: "http://xxx.xxx.xxx.xxx:9999",
// 設置HTTPS代理。
// httpsProxy: "https://username:password@xxx.xxx.xxx.xxx:9999",
});
return new CloudAuthClient(config);
}
async function contrastFaceVerify(endpoint, request) {
const client = createClient(endpoint);
// 創建RuntimeObject實例并設置運行參數。
const runtime = new RuntimeOptions([]);
runtime.readTimeout=10000;
runtime.connectTimeout=10000;
return await client.contrastFaceVerifyAdvance(request, runtime);
}
async function contrastFaceVerifyAutoRoute(request) {
const endpoints = [
"cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com"
];
for (const endpoint of endpoints) {
try {
const response = await contrastFaceVerify(endpoint, request);
if (response.statusCode === 500) {
continue;
}
if(response.body !== null){
if(response.body.code === "500"){
continue;
}
}
return response;
} catch (err) {
console.log(err);
continue;
}
}
return null;
}
async function main(){
const fileStream = fs.createReadStream("本地文件路徑");
// 通過以下代碼創建API請求并設置參數。
const request = new CloudAuth.ContrastFaceVerifyAdvanceRequest({
// 請輸入場景ID。
sceneId: xxx,
// 設置商戶請求的唯一標識。
outerOrderNo: "xxx",
// 要接入的認證方案。
productCode: "ID_MIN_VIDEO",
// 模式。
model: "FRONT_CAMERA_LIVENESS",
// 固定值。
certType: "IDENTITY_CARD",
certName: "張三",
certNo: "xxx",
faceContrastFileObject: fileStream
// mobile: "130xxxxxxxx",
// ip: "114.xxx.xxx.xxx",
// userId: "12345xxxx",
// deviceToken: "xxxxxxx",
// 如需開啟個人信息加密傳輸。
// encryptType: "SM2",
// certName: "BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==",
// certNo: "BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg=="
});
// 推薦,支持服務路由。
const response = await contrastFaceVerifyAutoRoute(request);
// 不支持服務自動路由。
// const response = await contrastFaceVerify("cloudauth.cn-shanghai.aliyuncs.com", request);
if (response){
console.log(response.body.requestId);
console.log(response.body.code);
console.log(response.body.message);
console.log(response.body.resultObject.certifyId);
}
fileStream.close();
}
main().then(function (response) {});
使用OSS對象存儲的方式
const Config = require("@alicloud/openapi-client");
const CloudAuth = require("@alicloud/cloudauth20190307");
const CloudAuthClient = CloudAuth.default;
const {RuntimeOptions} = require("@alicloud/tea-util");
const { default: Credential } = require('@alicloud/credentials')
function createClient(endpoint) {
// 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過阿里云Credentials工具從環境變量中讀取AccessKey,來實現API訪問的身份驗證。
const cred = new Credential();
const config = new Config.Config({
credential: cred,
// 設置Endpoint。
endpoint: endpoint,
// 設置HTTP代理。
// httpProxy: "http://xxx.xxx.xxx.xxx:9999",
// 設置HTTPS代理。
// httpsProxy: "https://username:password@xxx.xxx.xxx.xxx:9999",
});
return new CloudAuthClient(config);
}
async function contrastFaceVerify(endpoint, request) {
const client = createClient(endpoint);
// 創建RuntimeObject實例并設置運行參數。
const runtime = new RuntimeOptions([]);
runtime.readTimeout=10000;
runtime.connectTimeout=10000;
return await client.contrastFaceVerifyWithOptions(request, runtime);
}
async function contrastFaceVerifyAutoRoute(request) {
const endpoints = [
"cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com"
];
for (const endpoint of endpoints) {
try {
const response = await contrastFaceVerify(endpoint, request);
if (response.statusCode === 500) {
continue;
}
if(response.body !== null){
if(response.body.code === "500"){
continue;
}
}
return response;
} catch (err) {
console.log(err);
continue;
}
}
return null;
}
async function main(){
// 通過以下代碼創建API請求并設置參數。
const request = new CloudAuth.ContrastFaceVerifyRequest({
// 請輸入場景ID。
sceneId: xxx,
// 設置商戶請求的唯一標識。
outerOrderNo: "xxx",
// 要接入的認證方案。
productCode: "ID_MIN_VIDEO",
// 模式。
model: "FRONT_CAMERA_LIVENESS",
// 固定值。
certType: "IDENTITY_CARD",
certName: "張三",
certNo: "xxx",
ossBucketName: "cn-shanghai-aliyun-cloudauth-xxxxx",
ossObjectName: "verify/xxxxx/xxxxxx.mp4",
// mobile: "130xxxxxxxx",
// ip: "114.xxx.xxx.xxx",
// userId: "12345xxxx",
// deviceToken: "xxxxxxx",
// 如需開啟個人信息加密傳輸。
// encryptType: "SM2",
// certName: "BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==",
// certNo: "BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg=="
});
// 推薦,支持服務路由。
const response = await contrastFaceVerifyAutoRoute(request);
// 不支持服務自動路由。
// const response = await contrastFaceVerify("cloudauth.cn-shanghai.aliyuncs.com", request);
if (response){
console.log(response.body.requestId);
console.log(response.body.code);
console.log(response.body.message);
console.log(response.body.resultObject.certifyId);
}
}
main().then(function (response) {});
文檔內容是否對您有幫助?