调用本接口新建一个个体。

描述

业务接口/green/sface/person/add

新建个体时,必须指定个体要加入的组;可指定多个组,不存在的组将自动创建。人脸图片非必选,新建个体之后,可使用其它相应接口,对个体设置人脸信息。

请求参数

公共请求参数,参见公共参数

请求body是一个JSON对象,字段说明如下:
名称 类型 是否必需 描述
groupIds Json字符串数组 指定新建个体要加入的组ID列表。ID建议使用字母和数字组合。
personId String 新建个体的ID。ID建议使用字母和数字组合。
name String 新建个体的名称。
note String 备注。

返回参数

返回结果说明,参见返回结果

返回结果的data字段说明如下:
名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
personId 字符串 返回新增个体的ID。
groupIds 字符串 返回新增个体新加入的groupId列表。

示例

请求示例
{
  "personId":"person1",
  "groupIds": ["group1","group2"]
}
返回示例
{
  "code": 200, 
  "requestId": "36D384DA-8023-4E84-BCFD-0C5581352C16",
  "data":{
        "code":200,
        "personId":"person1",
        "groupIds":[
            "group1","group2"
         ]
    }
}