文档中心

简介

HI，您好，欢迎使用腾讯AI开放平台设置信息API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师，详细描述设置信息能力相关的技术内容。

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

官方交流一群：581197347

官方交流二群：705874401

官方交流三群：415349651

联系邮箱：[e-mail]

接口能力

接口名称	接口描述	API地址
设置信息	设置个体（Person）的名字或备注	https://api.ai.qq.com/fcgi-bin/face/face_setinfo

更多更强大的接口能力正在开发中，并逐步开放，敬请期待！

协议须知

调用方集成获取人列表API时，请遵循以下规则。

规则	描述
传输方式	HTTPS
请求方法	POST
字符编码	统一采用UTF-8编码
响应格式	统一采用JSON格式
接口鉴权	签名机制，详情请阅接口鉴权

设置信息接口

1. 接口描述

设置个体（Person）的名字或备注。

2. 请求参数

参数名称	是否必选	数据类型	数据约束	示例数据	描述
app_id	是	int	正整数	1000001	应用标识（AppId）
time_stamp	是	int	正整数	1493468759	请求时间戳（秒级）
nonce_str	是	string	非空且长度上限32字节	fa577ce340859f9fe	随机字符串
sign	是	string	非空且长度固定32字节		签名信息，详见接口鉴权
person_id	是	string	非空	person0	需要设置的个体（Person）ID
person_name	否	string	非空	name	新的名字
tag	否	string	非空	moreinfo	备注信息

3. 响应参数

参数名称	是否必选	数据类型	描述
ret	是	int	返回码； 0表示成功，非0表示出错
msg	是	string	返回信息；ret非0时表示出错时错误原因
data	是	object	返回数据；ret为0时有意义
+ person_id	是	string	设置的个体（Person）ID

4. 参考示例

假设示例请求数据如下。

参数名称	参数数据	描述
app_id	1000001	仅供参考
person_id	person0	仅供参考
person_name	name	仅供参考
tag	moreinfo	仅供参考
time_stamp		实时计算
nonce_str		实时计算
sign		实时计算

假设应用密钥为：a95eceb1ac8c24ee28b70f7dbba912bf。

下面使用PHP实现该HTTP API调用，其中getReqSign、doHttpPost可以从接口鉴权获取。

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'person_id'  => 'person0',
    'person_name'=> 'name',
    'tag'        => 'moreinfo',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/face/face_setinfo';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果（注意使用UTF-8编码）：

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "person_id": "person0"
    }
}