/person/create

Description

Create a person.

One Person may contain at most 10000 Faces
The app under developer status can  NOT create more than 100 persons.

Parameter

 NameDescription
Required api_key Your registered API Key
  api_secret Your registered API Secret
Optional person_name Name of the person, which must be unique in one API Key. Any character except "@" is allowed (quotes for clarification), but the length should not exceed 255. If omitted, a random unique name would be given.
  face_id A comma-separated list of face ids, which would be added to the person.
  tag A string to be associated with this person, which does not need to be unique and can be used to store any information. The length must not exceed 255.
  group_id or group_name A comma-separated list of group ids or names. If specified, the person would be added to the group immediately after creation.

Return Values

FieldTypeDescription
added_group int Number of groups the person belongs to
added_face int Number of successfully added faces
tag string Tag of the person
person_name string Name of the person
person_id string Id of the person

Parameter

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

JSON Response

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

Error Code List

Error CodeHTTP Status CodeError Message
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
 
Google+