猫酷开放平台

# 人脸识别

# 通过人脸获取用户信息

TIP

FaceImg选填，如不填写调用方应保证该FaceID对应人脸图片之前已经有传给猫酷。查询过程可能耗费较长时间，如果收到结果为“查询中”，请稍后重新调用接口查询。

接口地址：https://openapi10.mallcoo.cn/Facial/v1/Get/User/ByFace/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
VendorID int 是 供应商编号，由猫酷分配,请调用前确认好对应的编号，务必不能传错
FaceID string 是 厂商对该人脸的唯一编号
FaceImg string 否 人脸图片Base64编码格式（enCodeUrl编码,图片不大于1M，厂商应对图像进行裁剪，只保留人头部。人脸区域最小尺寸要求80*80，俯仰、左右角度在30度以内。图片中只有一个人头像存在，清晰无遮挡）

# 调用示例


{ 
	"VendorID": 1,
	"FaceID":"123456",
	"FaceImg": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAYAAAA8AXHiAAAgAElEQVR4Xuy9WZNdVZYm%2BJ3pju73%2BuyueRYSiEkghoiAgBiy%2FlZZ1UM9VFtXp1lbd790W721WVk%2FtVVlVmUQQERkEAJJIAkJIZDkLvmgyWe%2F4xnbvrX2Pve4IwIICYjODMccSXc8Z%2B9vr%2FFb..."
}
1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 是 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}
1
2
3
4
5
6
7



# 通过人脸获取用户信息V2

TIP

FaceImg选填，如不填写调用方应保证该FaceID对应人脸图片之前已经有传给猫酷。查询过程可能耗费较长时间，如果收到结果为“查询中”，请稍后重新调用接口查询。

接口地址：https://openapi10.mallcoo.cn/Facial/v2/Get/User/ByFace/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
VendorID int 是 供应商编号，由猫酷分配,请调用前确认好对应的编号，务必不能传错
FaceID string 是 厂商对该人脸的唯一编号
FaceImg string 否 人脸图片url地址

# 调用示例


{ 
	"VendorID": 1,
	"FaceID":"123456",
	"FaceImg": "http://e.hiphotos.baidu.com/image/pic/item/a1ec08fa513d2697e542494057fbb2fb4316d81e.jpg"
}
1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 是 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}
1
2
3
4
5
6
7



# 绑定人脸与用户关系

TIP

通过手机号绑定/解绑人脸与用户的关系。绑定时，Mobile、VendorID、FaceID、FaceImg必填；解绑时，【Mobile】或【VendorID、FaceID、FaceImg】必填其中一个，也可以都填写。绑定过程可能需要较长时间，如果收到结果为“绑定中”，请稍后重新调用接口查询绑定结果

接口地址：https://openapi10.mallcoo.cn/Facial/v1/Bind/UserFace/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Type int 是 操作类型（1:绑定；2:解绑）
VendorID int 是 供应商编号，由猫酷分配,请调用前确认好对应的编号，务必不能传错
FaceID string 是 厂商对该人脸的唯一编号
FaceImg string 是 人脸图片Base64编码格式(图片不大于1M，厂商应对图像进行裁剪，只保留人头部。人脸区域最小尺寸要求80*80，俯仰、左右角度在30度以内。图片中只有一个人头像存在，清晰无遮挡)
Mobile string 是 手机号
UserInfo string 否 用户信息（非标准Json字符串，需UTF-8 (UrlEncode)编码，注意：bool类型全部使用 0，1；多选字段用逗号拼接 “0,1,2”，如：HobbyList，FocusInfoList，AcceptInfoTypeList，ActiveInterestList 点击查看详细说明

# 调用示例


{ 
	"VendorID": 1,
	"FaceID":"123456",
	"FaceImg": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD/2wBDAAIBAQIBAQIC...",
	"Mobile": "15910456758",
	"UserInfo": "{\"UserName\":\"stefan\",\"Gender\":\"2\",\"Age\":\"20\",\"Birthday\":\"1985-01-01\",\"IDNum\":\"411123486404196754\",\"Email\":\"stefan@mallcoo.cn\",\"Education\":\"2\",\"Marital\":\"1\",\"HasChildren\":\"2\",\"ChildrenCount\":\"0\",\"Address\":\"111\",\"Business\":\"111\",\"Income\":\"0\",\"Conveyance\":\"0\",\"Wechat\":\"111111\",\"Reference\":\"11111\",\"InviteCode\":\"11111\",\"HobbyList\":\"0,4\",\"ThirdCardNo\":\"11111\",\"IsPostal\":\"0\",\"FocusInfoList\":\"0,4,8\",\"AcceptInfoTypeList\":\"0,2\",\"ShoppingInterestList\":\"0,4,8\",\"ActiveInterestList\":\"0,2\",\"CarNO\":\"苏A11111\",\"Remark1\":\"111\",\"Remark2\":\"1111\",\"Remark3\":\"dfgfg,ghjhjjj\"}"
}
1
2
3
4
5
6
7
8
9

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 是 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}
1
2
3
4
5
6
7



# 绑定人脸与用户关系V2

TIP

通过手机号绑定/解绑人脸与用户的关系。绑定时，Mobile、VendorID、FaceID、FaceImg必填；解绑时，【Mobile】或【VendorID、FaceID、FaceImg】必填其中一个，也可以都填写。绑定过程可能需要较长时间，如果收到结果为“绑定中”，请稍后重新调用接口查询绑定结果

接口地址：https://openapi10.mallcoo.cn/Facial/v2/Bind/UserFace/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Type int 是 操作类型（1:绑定；2:解绑）
VendorID int 是 供应商编号，由猫酷分配,请调用前确认好对应的编号，务必不能传错
FaceID string 是 厂商对该人脸的唯一编号
FaceImg string 是 人脸图片url地址
Mobile string 是 手机号
UserInfo string 否 用户信息（非标准Json字符串，需UTF-8 (UrlEncode)编码，注意：bool类型全部使用 0，1；多选字段用逗号拼接 “0,1,2”，如：HobbyList，FocusInfoList，AcceptInfoTypeList，ActiveInterestList 点击查看详细说明

# 调用示例


{ 
	"VendorID": 1,
	"FaceID":"123456",
	"FaceImg": "http://e.hiphotos.baidu.com/image/pic/item/a1ec08fa513d2697e542494057fbb2fb4316d81e.jpg",
	"UserInfo": "{\"UserName\":\"stefan\",\"Gender\":\"2\",\"Age\":\"20\",\"Birthday\":\"1985-01-01\",\"IDNum\":\"411123486404196754\",\"Email\":\"stefan@mallcoo.cn\",\"Education\":\"2\",\"Marital\":\"1\",\"HasChildren\":\"2\",\"ChildrenCount\":\"0\",\"Address\":\"111\",\"Business\":\"111\",\"Income\":\"0\",\"Conveyance\":\"0\",\"Wechat\":\"111111\",\"Reference\":\"11111\",\"InviteCode\":\"11111\",\"HobbyList\":\"0,4\",\"ThirdCardNo\":\"11111\",\"IsPostal\":\"0\",\"FocusInfoList\":\"0,4,8\",\"AcceptInfoTypeList\":\"0,2\",\"ShoppingInterestList\":\"0,4,8\",\"ActiveInterestList\":\"0,2\",\"CarNO\":\"苏A11111\",\"Remark1\":\"111\",\"Remark2\":\"1111\",\"Remark3\":\"dfgfg,ghjhjjj\"}"
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 是 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}
1
2
3
4
5
6
7
Last Updated: 2021/5/6 下午2:58:52

← BI数据 →