Skip to content

Bandido Person API Documentation

Jump to bottom
Peter Graham edited this page Jul 30, 2013 · 4 revisions

Bandido has a RESTful API for sharing people.

URLs

POST /people to create a person page

Headers

  • CONTENT-TYPE: application/x-www-form-urlencoded
  • X-ACOM-ATT: att_token_value (for user authentication)

Body

Specify the following parameters in the body of your request:

  • tree_id: the tree ID that the person is attached to
  • person_id: the ID of the person
  • referrer[client]: string that represents the client being shared from, e.g. Website or iOS
  • referrer[page]: string that represents the page being shared from, e.g. PersonHints or InteractiveImageViewer

Response

We return JSON with sharable url and other helpful data.

{
  "ancestry_id": "6984126192",
  "avatar_crop_height": null,
  "avatar_crop_width": null,
  "avatar_crop_x": null,
  "avatar_crop_y": null,
  "avatar_url": "http://mediasvc.ancestry.com/image/f442d445-bda6-4340-a209-bbbd1fbd8d19.jpg?Client=Trees&NamespaceID=1093",
  "birth_date": "1891-01-01T00:00:00+00:00",
  "death_date": "1956-01-01T00:00:00+00:00",
  "gender": "male",
  "name": "John Smith",
  "first_name": "John",
  "last_name": "Smith",
  "caption": "John Smith was born in 1891 in Vermont. He married Mary Graham in 1876. John died in 1956 at the age of 65.",
  "sharer_id": "00e92f1c-0006-0000-0000-000000000000",
  "sharer_name": "Peter Graham",
  "sharer_first_name": "Peter",
  "sharer_email": "peter.graham@ancestry.com",
  "tree_id": "47735199",
  "title": "John Smith discovered on Ancestry.com",
  "url": "http://story.sharing.ancestry.com/people/402513?h=fd2143",
  "id": 402513,
  "hmac_id": "fd2143",
  "created_at": "2013-07-03T18:21:58+00:00",
  "updated_at": "2013-07-11T06:16:07+00:00"
}

Clone this wiki locally