/person/create

描述

创建一个Person

一个Person最多允许包含10000个Face。
开发版最多允许创建100个person。

参数

 参数名参数说明
必须 api_key App的Face++ API Key
  api_secret APP的Face++ API Secret
可选 person_name Person的Name信息,必须在App中全局唯一。Name不能包含^@,&=*'"等非法字符,且长度不得超过255。Name也可以不指定,此时系统将产生一个随机的name。
  face_id 一组用逗号分隔的face_id, 表示将这些Face加入到该Person中
  tag Person相关的tag,不需要全局唯一,不能包含^@,&=*'"等非法字符,长度不能超过255。
  group_id 或 group_name 一组用逗号分割的group id列表或者group name列表。如果该参数被指定,该Person被create之后就会被加入到这些组中。

返回值说明

字段类型说明
added_group int 成功被加入的group数量
added_face int 成功加入的face数量
tag string person相关的tag
person_name string 相应person的name
person_id string 相应person的id

调用示例

https://apicn.faceplusplus.com/v2/person/create?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&tag=demotest&person_name=NicolasCage&group_name=SuperStars

JSON 示例

{
    "added_face": 0,
    "added_group": 1,
    "person_id": "c1e580c0665f6ed11d510fe4d194b37a", 
    "person_name": "NicolasCage",
    "tag": "demotest"
}

错误列表

错误代码HTTP 状态代码错误信息
1001 500 INTERNAL_ERROR
1003 403 AUTHORIZATION_ERROR
1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED
1004 400 MISSING_ARGUMENTS
1008 400 TOO_MANY_ITEMS_TO_ADD
1005 400 INVALID_ARGUMENTS
1006 403 ILLEGAL_USE_OF_DEMO_KEY
1202 502 SERVER_TOO_BUSY
1501 451 BAD_NAME
1502 452 BAD_TAG
1503 453 NAME_EXIST