How to be successful with the Family Search API

1© 2014 by Intellectual Reserve, Inc. All rights reserved.

How to Succeed to beginning

development with the

FamilySearch APIVaughn Hepworth

2

Developers New to Web Development

Most developers we work with are familiar with

some form of programming

Most Developers are looking for quick entry to

making calls

3

Authentication (OAuth 2.0)

OAuth 2.0 is not a concept normally used with

non web developers.

4

Various Internet Technologies

There are many various technologies that

developers must be familiar with HTTP

REST

XML/JSON

Media Types

URI

5

Components of a successful Call

What is required to make a successful call

within the FS API?

6

How can I be successful?

Getting Started (guides)

SDKs w/ Reference Libraries

FSDN

Authentication (OAuth 2.0)

Other Tools

7

Guides

8

Getting Started

9

Authentication Guide

10

SDK’s

11

FSDN

Ask questions to other developers working with the same API Get notified of any upcoming changes, releases, or fixes Learn what others are doing within the Genealogy community

12

Requirements for Making a Call

13

Requirements for Making a Call

Endpoint URI

Headers

Accept

Authorization

https://familysearch.org/platform/tree/persons/KWQM-1T9

application/x-fs-v1+xml

bearer <access_token>

14

Authentication

Your App Family Search(Authorization endpoint)

Login Page

Obtain Access Token

Redirect to AppYour App

Redirect

Redirects to the Callback URI

Auth Code in URL Param

POST auth code to Access Token Endpoint

15

Dev HTTP Client (Chrome Plugin)

16

Resources

Email Support

devsupport@familysearch.org

Developers website:

https://familysearch.org/developers