調用addFaces接口為個體新增一組人臉圖片。
一個個體最多允許包含20張人臉圖片。
如果您在添加人臉圖片后的1年內未調用過任何人臉檢索相關的接口（請參見圖片人臉檢索），人臉圖片和人臉分組會被清空。
QPS限制
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
請求語法
POST /green/sface/face/add HTTPS|HTTP請求頭
該接口使用公共請求頭，無特殊請求頭。請參見公共請求頭。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
clientInfo | JSONObject | 否 | {"userId":"120234234","userNick":"Mike","userType":"others"} | 客戶端信息，由ClientInfo結構體通過JSON序列化獲得，包含umid、imei等信息，具體結構描述，請參見ClientInfo。 |
RequestBody
RequestBody中還需要填入以下參數，用來指定個體和人臉圖片信息。
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
bizType | String | 否 | edu | 業務場景類型。 |
personId | String | 是 | person1 | 目標個體的ID。 說明 您可以調用/green/sface/group/persons獲取所有個體ID。 |
urls | StringArray | 是 | ["http://www.aliyundoc.com/xxx01.jpg","http://www.aliyundoc.com/xxx02.jpg"] | 要添加的人臉圖片的URL列表。 |
返回數據
所有請求均返回JSON格式的數據。關于返回數據中的公共字段，請參見公共返回參數。返回數據中的data字段表示與業務相關的數據，一般是一個JSON結構體或數組。
響應出錯的情況下，data字段可能為空。
該接口返回的data字段包含以下參數。
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼，和HTTP狀態碼一致。 更多信息，請參見公共錯誤碼。 |
groupId | StringArray | ["foreign1"] | 個體所屬的個體組ID。 |
personId | String | person1 | 個體ID。 |
faceImageItems | JSONArray | 已添加的人臉信息。具體結構描述，請參見faceImageItem。 |
表 1. faceImageItem
名稱 | 類型 | 示例值 | 描述 |
faceId | Float | 23088737259260929 | 人臉ID。 |
success | Boolean | true | 是否成功添加人臉。取值：
|
示例
請求示例
POST /green/sface/face/add HTTP/1.1
公共請求頭
{
"personId": "person1",
"urls": [
"http://www.aliyundoc.com/xxx01.jpg",
"http://www.aliyundoc.com/xxx02.jpg"
]
}正常返回示例
{
"msg": "OK",
"code": 200,
"requestId": "36D384DA-8023-4E84-BCFD-0C5581352C16",
"data": {
"code": 200,
"groupIds": [
"foreign1"
],
"personId": "person1",
"faceImageItems": [
{
"success": true,
"faceId": 23088737259260929
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。