Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

FamilySearch client API for node.js

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 example
Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 index.js
Octocat-spinner-32 package.json
README.md

Asynchronous FamilySearch client API for Node.js

fsapi is a client library for accessing the FamilySearch APIs from Node.js

Build Status

Version 0.1.0

Installation

You can install fsapi and its dependencies with npm by adding it to your package.json, or running npm install fsapi.

"dependencies": {
  "fsapi": "0.1.0"
}

Getting started

There is a simple example Express application in the example directory. To run the example, you need to add your developer key in place of the developerKey: 'NNNN-NNNN-NNNN-NNNN-NNNN-NNNN-NNNN-NNNN', and then run:

node example.js

You can test the app in your browser at http://127.0.0.1:3113/ Ig you want to run it on a different host, then update the callbackURL: "http://127.0.0.1:"+PORT+"/auth/familysearch/callback" to match where you are running it.

Setup API

The developerKey listed below can be obtained from devnet.familysearch.org/.

var FSApi = require('fsapi');

var fsapi = require('../lib/fsapi')({
  developerKey: 'NNNN-NNNN-NNNN-NNNN-NNNN-NNNN-NNNN-NNNN',
  userAgent: "node-fsapi-example-express/0.1.0",
  referenceHost: "https://sandbox.familysearch.org",
  callbackURL: "http://127.0.0.1:"+PORT+"/auth/familysearch/callback"
});

The required parameters are developerKey and callbackURL, which must match the URL where your app can be reached.

If you leave referenceHost blank, it will default to https://api.familysearch.org

REST API

fsapi.pedigree('KWC8-Q7X', function (err, data) {
console.log(console.dir(data));

});

Search API

fsapi.search('Theras Orson Allred', function(err, data) {
    console.log(console.dir(data));
});

Contributors

TODO

  • document the proxy
  • search
  • pedigree
  • person read
Something went wrong with that request. Please try again.