Attention: This site does not support the current version of your web browser. To get the best possible experience using our website we recommend that you upgrade to a newer version or install another browser

Persons

Description

The Persons resource provides the interface to create a person, including the name, gender or facts of the person.

Data Formats

Readable

If you make a GET request, specify the desired data format using the Accept header.

Writable

If you POST something, specify the data format using the Content-Type header.

Parameters

Name Type Description
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
X-Reason header Header giving the reason for creating a person.
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.
pids query A comma separated list of person ids.

Operations

GET - Read a list of persons. Invalid ids will be returned in Warning headers. The maximum number of ids to read is currently 500, but is subject to change.

Status Codes
200 Upon a successful read.
301 If a requested person has been merged into another person.
400 If the request was unable to be understood by the application.
404 If a requested person is not found.
410 If a requested person has been deleted.
429 If the request was throttled.

POST - Create a person.

Status Codes
201 The creation of the person was successful. Expect a location header specifying the link to the created person.
429 If the request was throttled.

Example Requests

Create Person How to create a person.
Read Persons How to read multiple persons.
x

Select a language