Step1: 制作签名

活体检测API接口签名方法需遵循“AWS API 2.0 签名规范”。

需要将签名字段按照如下方法进行拼接，并按照指定Hash算法计算后，以base64编码方式进行编码。

签名地址字段

字段

格式要求

说明

可选值

POST\n

大写、以换行\n结束

HTTP请求方法

必选

mosapi.meituan.con\n

小写，以换行\n结束

API服务主机名

必选

/mcs/v1\n\n

小写，以换行\n结束

请求绝对路径

必选

注：将所有签名地址字段拼接成string类型的字符串

例如：

POST\nmosapi.meituan.com\n/mcs/v1\n

签名参数字段

字段

类型

说明

可选值

Action

string

LivenessDetection

必选

AWSAccessKeyId

string

访问API请求的ACCESS KEY ID

(用户在美团云控制台"API秘钥"可找到该值)

必选

SignatureVersion

string

2

必选

Timestamp

string

请求时间戳，iso8601格式：YYYY-MM-DDTHH:MM:SS.MMMZ

必选

SignatureMethod

string

数字签名的Hash算法，可能的值为"HmacSHA256"和"HmacSHA1"，分别对应SHA256和SHA1算法

必选

Format

string

json

必选

action_type_list

string

动作列表，包含1到2个动作，1为张嘴，2为闭眼

必选

check_anti_screen_threshold

string

防屏幕翻拍阈值，有 high、medium、low 三种选择

可选，默认为high

check_anti_picture_threshold

string

防照片检测阈值，有 high、medium、low 三种选择

可选，默认为medium

check_anti_eye_blockage_threshold

string

眼部遮挡检测阈值，有 high、medium、low 三种选择

可选，默认为medium

check_anti_hole_threshold

string

防孔洞检测阈值，有 high、medium、low 三种选择

可选，默认为medium

注：所有签名参数按照参数名称的

字典顺序进行排序，并以

x-www-form-urlencoded

编码拼接在一起：

为了保证认证通过请务必对请求参数进行URI编码，参数中的空格务必编码为%20。将空格编码为+会导致认证不通过。

例如：

AWSAccessKeyId=8b5ad48388a347c185b6b7b0ba9e6225&Action=GetBalance&Format=json&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2016-11-14T03%3A10%3A55.000Z

签名内容拼接

将签名地址、签名参数(字典序排序后)以

拼接成string类型的字符串：

例如：

POST\nmosapi.meituan.com/mcs/v1\nAWSAccessKeyId=8b5ad48388a347c185b6b7b0ba9e6225&Action=GetBalance&Format=json&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2016-11-14T03%3A10%3A55.000Z

生成签名

用SECRET KEY作为秘钥对拼接后的签名内容以HmacSHA256算法进行Hash加密，并进行base64编码，最终获得签名:

例如：

xOnd5MauvUn8Kx8225Nh7tSYnuIB0oi5H2Jb00UU788=

Step2: 接口调用

接口：https://mosapi.meituan.com/mcs/v1

方法：POST

请求参数

参数名

类型

说明

可选项

Action

string

LivenessDetection

必选

AWSAccessKeyId

string

访问API请求的ACCESS KEY ID

(用户在美团云控制台"API秘钥"可找到该值)

必选

SignatureVersion

string

数字签名算法版本，该值为2

必选

Timestamp

string

请求时间戳，iso8601格式：YYYY-MM-DDTHH:MM:SS.MMMZ

必选

SignatureMethod

string

数字签名的Hash算法，可能的值为"HmacSHA256"和&"HmacSHA1",分别对应SHA256和SHA1算法

必选

Signature

string

请求内容的数字签名，具体签名生成算法见上文的数字签名生成方法

必选

Format

string

返回内容的编码格式，值为json

必选

video_content

string

经base64编码的视频内容(要求视频为MP4格式)

必选

注：以上为HTTP请求包body中对应值，需要以

x-www-form-urlencoded

编码拼接在一起后才可进行HTTP请求

为了保证认证通过请务必对请求参数进行URI编码，参数中的空格务必编码为%20。将空格编码为+会导致认证不通过。

返回参数

返回类型：json

参数名

类型

说明

is_anti_screen_check_passed

bool

防屏幕翻拍的验证结果

is_anti_picture_check_passed

bool

防照片的判断结果,是否通过测试

is_anti_eye_blockage_check_passed

bool

防眼部遮挡的结果,是否通过测试

is_anti_hole_check_passed

bool

防孔洞检测的结果,是否通过测试

query_image_contents

list

活体检测成功会从视频中截取2张人脸图片，经base64编码后返回

video_liveness_status

int

活体检测状态 状态码及建议

-1 初始化失败

0 检测通过

1 疑似攻击,检测未通过

2 长时间未检测到第一个动作

3 未检测到闭眼动作

4 未检测到张嘴动作

11 脸离屏幕太近,未通过后端检测

12 脸离屏幕太远,未通过后端检测

13 由于脸太靠左,未通过后端检测

14 由于脸太靠右,未通过后端检测

15 光线太暗,未通过后端检测

返回结果结构如下：

{

"code": 200,

"err": "",

"ret": {

"liveness_detection_result": {

"is_anti_screen_check_passed": true,

"is_anti_picture_check_passed": true,

"is_anti_eye_blockage_check_passed": true,

"is_anti_hole_check_passed": true,

"query_image_contents": [

"BASE64_1","BASE64_2"

],

"video_liveness_status": 0

}

}

}

示例代码

Python示例代码

示例代码采用Python3版本

action字段内容对应Action内容

access_key、secret_key对应控制台中的Access Key ID、Access Key Secret

#! /usr/bin/env python3

#-*- coding:utf-8 -*-

import base64

import datetime

import hmac

import hashlib

import urllib

import urllib.parse

import requests

import json

access_key = '' # Access Key ID

secret_key = '' # Secret Key

video = '/users/zibaodejidan/Desktop/test.png' # 视频文件所在地址

action_type_list = '[1,2]'

check_anti_screen_threshold ='high'

check_anti_picture_threshold = 'high'

check_anti_eye_blockage_threshold = 'high'

check_anti_hole_threshold = 'high'

action = 'LivenessDetection'

url = 'https://mosapi.meituan.com/mcs/v1'

def get_utf8_value(value):

if not isinstance(value, str): #and not isinstance(value, unicodedata):#(python2版本需要此句)

value = str(value)

if isinstance(value, str): #unicode):#(python2版本需要此句)

return value.encode('utf-8')

else:

return value

def sign(params):

pairs = []

for key in params.keys():

val = get_utf8_value(params[key])

val = urllib.parse.quote(val, safe='-_~')

pairs.append(urllib.parse.quote(key, safe='') + '=' + val)

query = '&'.join(sorted(pairs))

msg = ('POST\nmosapi.meituan.com\n/mcs/v1\n%s' % query)

content = hmac.new(secret_key.encode('utf-8'), msg.encode('utf-8'), hashlib.sha256).digest()

ret = base64.b64encode(content).decode()

return ret

def get_video():

with open(video, 'rb') as f1:

vid = base64.b64encode(f1.read())

return vid

def pack_data():

data = {

'AWSAccessKeyId':access_key,

'Action': action,

'Format': 'json',

'SignatureMethod': 'HmacSHA256',

'SignatureVersion': '2',

'Timestamp': datetime.datetime.now().isoformat()[0:-3]+'Z',

'action_type_list' : action_type_list,

'check_anti_screen_threshold' : check_anti_screen_threshold,

'check_anti_picture_threshold' : check_anti_picture_threshold,

'check_anti_eye_blockage_threshold' : check_anti_eye_blockage_threshold,

'check_anti_hole_threshold' : check_anti_hole_threshold,

}

data.update({'Signature' : sign(data)})

data.update({'video_content' : get_video()})

return data

def request():

data = urllib.parse.urlencode(pack_data())

headers = {

'Content-type': 'application/x-www-form-urlencoded',

'Accept': 'text/plain'

}

response = requests.post(

url = url, data = data, headers = headers, verify = True

)

resp_format = json.loads(response.content.decode('utf-8'))

return resp_format

if __name__ == '__main__':

print(request())

PHP示例代码

$key_id = '您自己的 key_id';

$key_secret = '您自己的 key_secret';

$url = 'https://mosapi.meituan.com/mcs/v1';

$video_location = '您自己的本地视频路径';

function signature($post_array){

$string_to_sign = "POST\n";

$string_to_sign .= "mosapi.meituan.com\n";

$string_to_sign .= "/mcs/v1\n";

$string_to_sign .= array2xform($post_array);

global $key_secret;

$signature = base64_encode(hash_hmac('sha256', $string_to_sign, $key_secret, true));

return $signature;

}

function array2xform($post_array){

$string='';

foreach ($post_array as $k => $v) {

$string .= "&$k=".rawurlencode($v);

}

$string = substr($string, 1);

return $string;

}

$file = fopen($video_location, 'rb');

$data = fread($file,filesize($video_location));

fclose($file);

$video_content = base64_encode($data);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);

$post_array = array(

'AWSAccessKeyId' => $key_id,

'Action' => 'LivenessDetection',

'Format' => 'json',

'SignatureMethod' => 'HmacSHA256',

'SignatureVersion' => 2,

'Timestamp' => date('Y-m-d\TH:i:s.0000\Z', time()),

'action_type_list' => '[1,2]'

);

$post_array['Signature'] = signature($post_array);

$post_array['video_content'] = $video_content;

$post_string = array2xform($post_array);

curl_setopt($ch, CURLOPT_POSTFIELDS, $post_string);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$out = curl_exec($ch);

curl_close($ch);

echo $out;