familysearch 0.2.0 → 0.3.0

data/lib/familysearch/error.rb

@@ -0,0 +1,29 @@
+module FamilySearch
+  # namespace for all of the errors that will be raised by this gem.
+  module Error
+    # To be raised if there is any problem with an HTTP request, meaning 40x-50x error.
+    class ClientError < StandardError
+      attr_reader :response
+      # Allows raising an error and having the error keep the response object with it for debugging purposes.
+      def initialize(response = {})
+        @response = response
+      end
+    end
+    # Raised if the client cannot successfully authenticate with basic_auth! method.
+    class BadCredentials < ClientError; end
+    #-- 
+    # Template Related Errors
+    #++
+    
+    # Raised if a template is not found on FamilySearch::Client#template call
+    class URLTemplateNotFound < StandardError; end
+    
+    # Raised if a get, post, put, or delete method is called on a FamilySearch::URLTemplate that
+    # doesn't support those methods.
+    class MethodNotAllowed < StandardError; end
+    
+    # Raised if a parameter is passed to a get (or other method call) on a FamilySearch::URLTemplate object
+    # that doesn't contain that parameter in the template string.
+    class TemplateValueNotFound < StandardError; end
+  end
+end

data/lib/familysearch/middleware.rb

@@ -0,0 +1,2 @@
+require 'familysearch/middleware/response/familysearch_errors'
+require 'familysearch/middleware/response/multi_json'

data/lib/familysearch/middleware/response/familysearch_errors.rb

@@ -0,0 +1,22 @@
+require 'faraday'
+
+module FamilySearch
+  # Middleware specific to the +familysearch+ gem
+  module Middleware
+    # Handles the raising of errors within the Faraday call stack. 
+    class RaiseErrors < Faraday::Response::RaiseError
+      # If a 400-600 error is raised by the HTTP call, raise it within the app.
+      def on_complete(env)
+        case env[:status]
+        when 401
+          # response_values is a method of the RaiseError class
+          raise FamilySearch::Error::BadCredentials, response_values(env) 
+        when 400...600
+          raise FamilySearch::Error::ClientError, response_values(env)
+        end
+      end
+    end
+  end
+end
+
+Faraday.register_middleware :response, :familysearch_errors => FamilySearch::Middleware::RaiseErrors

data/lib/familysearch/middleware/response/multi_json.rb

@@ -0,0 +1,22 @@
+require 'faraday'
+require 'multi_json'
+
+module FamilySearch
+  module Middleware
+    # Parses the response from JSON into a Hash. This uses the +multi_json+ gem to provide
+    # more flexibility in JSON parser support and to better support other ruby environments such
+    # as JRuby, Rubinius, etc.
+    class MultiJsonParse < Faraday::Response::Middleware
+      dependency do
+        require 'json' unless defined?(::JSON)
+      end
+      
+      # The method that has MultiJson parse the json string.
+      def parse(body)
+        MultiJson.load(body)
+      end
+    end
+  end
+end
+
+Faraday.register_middleware :response, :multi_json => FamilySearch::Middleware::MultiJsonParse

data/lib/familysearch/url_template.rb

@@ -0,0 +1,132 @@
+module FamilySearch
+  # Used to make calls on templates that are exposed through the Discovery Resource.
+  # 
+  # It wouldn't be expected that a developer would access this class directly, but is the
+  # resulting object of a FamilySearch::Client#template call.
+  # 
+  # =Usage:
+  # 
+  # To use the URLTemplate, access the template from the FamilySearch::Client object like so:
+  # 
+  #   client = FamilySearch::Client.new
+  #   res = client.template('person').get :pid => 'KWQS-BBQ'
+  #   res.body['persons'][0]['id] # => 'KWQS-BBQ'
+  # 
+  # For information on which templates are available, see the discovery resource.
+  # 
+  # [sandbox] https://sandbox.familysearch.org/.well-known/app-meta.json
+  # 
+  # [production]  https://familysearch.org/.well-known/app-meta.json
+  # 
+  class URLTemplate
+    attr :template, :type, :accept, :allow, :title
+    
+    # Instantiate a new FamilySearch::URLTemplate
+    # 
+    # *Args*    :
+    # - +client+: a FamilySearch::Client object.
+    # - +template_hash+: a hash containing template values from the Discovery Resource.
+    #   Example:
+    #     {
+    #       "template" => "https://sandbox.familysearch.org/platform/tree/persons/{pid}{?access_token}",
+    #       "type" => "application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html",
+    #       "accept" => "application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml",
+    #       "allow" => "HEAD,GET,POST,DELETE,GET,POST",
+    #       "title" => "Person"
+    #     }
+    # *Returns* :
+    # - +FamilySearch::URLTemplate+ object
+    # *Raises*  :
+    # - +FamilySearch::Error::URLTemplateNotFound+: if the template_hash is nil. 
+    #   This is intended to catch problems if FamilySearch::Client#template method doesn't find 
+    #   a template and still instantiates this object.
+    # 
+    def initialize(client,template_hash)
+      raise FamilySearch::Error::URLTemplateNotFound if template_hash.nil?
+      @client = client
+      @template = template_hash['template']
+      @type = template_hash['type']
+      @accept = template_hash['accept']
+      @allow = template_hash['allow'].split(',').map{|v|v.downcase}
+      @title = template_hash['title']
+    end
+    
+    # Calls HTTP GET on the URL template. It takes the +template_values+ hash and merges the values into the template.
+    # 
+    # A template will contain a URL like this:
+    #   https://sandbox.familysearch.org/platform/tree/persons-with-relationships{?access_token,person}
+    # or
+    #   https://sandbox.familysearch.org/platform/tree/persons/{pid}/matches{?access_token}
+    # 
+    # The {?person} type attributes in the first example will be passed as querystring parameters. These will automatically be URL Encoded
+    # by the underlying Faraday library that handles the HTTP request.
+    # 
+    # The {pid} type attibutes will simply be substituted into the URL.
+    # 
+    # *Note*: The +access_token+ parameter doesn't need to be passed here. This should be handled by the FamilySearch::Client's
+    # Authorization header.
+    # 
+    # *Args*    :
+    # - +template_values+: A Hash object containing the values for the items in the URL template. For example, if the URL is:
+    #     https://sandbox.familysearch.org/platform/tree/persons-with-relationships{?access_token,person}
+    #   then you would pass a hash like this:
+    #     :person => 'KWQS-BBQ'
+    #   or
+    #     'person' => 'KWQS-BBQ'
+    # *Returns* :
+    # - +Faraday::Response+ object. This object contains methods +body+, +headers+, and +status+. +body+ should contain a Hash of the 
+    #   parsed result of the request.
+    # *Raises*  :
+    # - +FamilySearch::Error::MethodNotAllowed+: if you call +get+ for a template that doesn't allow GET method.
+    # 
+    def get(template_values)
+      raise FamilySearch::Error::MethodNotAllowed unless allow.include?('get')
+      template_values = validate_values(template_values)
+      url = make_url(template_values)
+      params = make_params(template_values)
+      @client.get url, params
+    end
+    
+    private
+    def value_array
+      template_value_array = []
+      values = @template.scan(/\{([^}]*)\}/).flatten
+      values.each do |value|
+        value.gsub!('?','')
+        template_value_array += value.split(',')
+      end
+      template_value_array
+    end
+    
+    def validate_values(template_values)
+      vals = value_array
+      stringified_hash = {}
+      template_values.each do |k,v|
+        stringified_hash[k.to_s] = v
+        raise FamilySearch::Error::TemplateValueNotFound unless vals.include?(k.to_s)
+      end
+      stringified_hash
+    end
+    
+    def make_url(template_values)
+      url = @template.gsub(/\{\?[^}]*\}/,'')
+      template_values.each do |k,v|
+        to_replace = "{#{k}}"
+        url.gsub!(to_replace,v)
+      end
+      url
+    end
+    
+    def make_params(template_values)
+      to_remove = url_values
+      to_remove.each do |v|
+        template_values.delete(v)
+      end
+      template_values
+    end
+    
+    def url_values
+      @template.scan(/\{(\w*)\}/).flatten
+    end
+  end
+end

data/lib/familysearch/version.rb

@@ -0,0 +1,4 @@
+module FamilySearch
+  # The version of the familysearch gem. Can be accessed from code FamilySearch::VERSION
+  VERSION = "0.3.0"
+end

data/spec/client_spec.rb

@@ -91,7 +91,6 @@ describe FamilySearch::Client do
     it "should make a request " do
       VCR.use_cassette('discovery') do
         client.discover!
-        client.discovery.links.fs_identity_v2_login.href.should == 'https://sandbox.familysearch.org/identity/v2/login'
         client.discovery['links']['fs-identity-v2-login']['href'].should == 'https://sandbox.familysearch.org/identity/v2/login'
       end
     end
@@ -128,5 +127,107 @@ describe FamilySearch::Client do
         client.basic_auth! 'api-user-1241', '1782'
       end
     end
+    
+    it "should raise an error if the username or password are incorrect" do
+      VCR.use_cassette('discovery_auth_wrong_creds') do
+        expect {client.basic_auth! 'api-user-1241', '1783' }.to raise_error(FamilySearch::Error::BadCredentials)
+      end
+    end
+    
+    it "should have some response objects on the exception that is raised" do
+      VCR.use_cassette('discovery_auth_wrong_creds') do
+        begin
+          client.basic_auth! 'api-user-1241', '1783'
+        rescue FamilySearch::Error::BadCredentials => bc
+          bc.response[:status].should == 401
+          bc.response[:headers].should be_kind_of(Hash)
+          bc.response[:body].should be_kind_of(Hash)
+        end
+      end
+    end
+  end
+  
+  describe "get" do
+    def client()
+      unless @client
+        @client = FamilySearch::Client.new(:key => 'WCQY-7J1Q-GKVV-7DNM-SQ5M-9Q5H-JX3H-CMJK' )
+        @client.discover!
+        @client.basic_auth! 'api-user-1241', '1782'
+      end
+      @client
+    end
+    
+    # The following specs were put in place to record the VCR cassette so that I could develop on the road...
+    it "should read the current user person" do
+      VCR.use_cassette('current_user_person_read') do
+        person = client.get client.discovery['links']['current-user-person']['href']
+      end
+    end
+    
+    it "should read a person by ID" do
+      VCR.use_cassette('person_by_id') do
+        person = client.get 'https://sandbox.familysearch.org/platform/tree/persons/KWQX-52J'
+      end
+    end
+    
+    it "gets the persons-with-relationships resource" do
+      VCR.use_cassette('person_with_relationship') do
+        person = client.get 'https://sandbox.familysearch.org/platform/tree/persons-with-relationships?person=KWQX-52J'
+      end
+    end
+  end
+  
+  describe "template" do
+    def client()
+      unless @client
+        @client = FamilySearch::Client.new(:key => 'WCQY-7J1Q-GKVV-7DNM-SQ5M-9Q5H-JX3H-CMJK' )
+        @client.discover!
+        @client.basic_auth! 'api-user-1241', '1782'
+      end
+      @client
+    end
+    
+    it "should take a key as a string and return a FamilySearch::URLTemplate object" do
+      VCR.use_cassette('person_by_id') do
+        client.template('person-template').should be_instance_of(FamilySearch::URLTemplate)
+      end
+    end
+    
+    it "should raise an error if there is no template found for the key" do
+      VCR.use_cassette('person_by_id') do
+        expect {client.template('yodawg-template')}.to raise_error(FamilySearch::Error::URLTemplateNotFound)
+      end
+    end
+    
+    it "should allow you to take -template off of the key attribute" do
+      VCR.use_cassette('person_by_id') do
+        person_template = client.template('person')
+        person_template.should be_instance_of(FamilySearch::URLTemplate)
+        person_template.title.should == "Person"
+      end
+    end
+    
+    it "should allow you to take -query off of the key attribute" do
+      VCR.use_cassette('person_by_id') do
+        person_template = client.template('ancestry')
+        person_template.should be_instance_of(FamilySearch::URLTemplate)
+        person_template.title.should == "Ancestry"
+      end
+    end
+    
+    it "should allow you to use a symbol as the key attribute" do
+      VCR.use_cassette('person_by_id') do
+        person_template = client.template(:ancestry)
+        person_template.should be_instance_of(FamilySearch::URLTemplate)
+        person_template.title.should == "Ancestry"
+      end
+    end
+    
+    it "should allow you to make a call to a template and get a result" do
+      VCR.use_cassette('person_by_id') do
+        result = client.template('person').get 'pid' => 'KWQX-52J'
+        result.body.should be_kind_of(Hash)
+      end
+    end
   end
 end

data/spec/fixtures/vcr_cassettes/current_user_person_read.yml

@@ -0,0 +1,503 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://sandbox.familysearch.org/.well-known/app-meta
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/x-fs-v1+json
+      User-Agent:
+      - Faraday v0.8.7
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Apache-Coyote/1.1
+      Content-Location:
+      - /.well-known/app-meta
+      Cache-Control:
+      - no-transform, max-age=604800
+      X-Processing-Time:
+      - '167'
+      Content-Type:
+      - application/x-fs-v1+json
+      Transfer-Encoding:
+      - chunked
+      Date:
+      - Tue, 26 Mar 2013 15:16:59 GMT
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"links\" : {\n    \"person-change-summary-template\" : {\n
+        \     \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/change-summary{?access_token}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Change Summary\"\n    },\n    \"person-notes-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/notes{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Notes\"\n    },\n    \"couple-relationship-note-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/notes/{nid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST,DELETE\",\n      \"title\" : \"Note\"\n    },\n
+        \   \"person-restore-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/restore{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"POST\",\n      \"title\" : \"Restore\"\n    },\n    \"couple-relationship-source-reference-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/source-references/{srid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Source Reference\"\n    },\n
+        \   \"source-description-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/sources/descriptions/{sdid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE\",\n      \"title\" : \"Source Description\"\n
+        \   },\n    \"child-and-parents-relationship-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE\",\n      \"title\" : \"Child-and-Parents
+        Relationship\"\n    },\n    \"discussions\" : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/discussions/discussions\",\n
+        \     \"title\" : \"Discussions\"\n    },\n    \"child-and-parents-relationship-conclusion-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/{role}/conclusions/{cid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"FamilySearch Conclusion\"\n
+        \   },\n    \"couple-relationship-conclusion-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/conclusions/{cid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Conclusion\"\n    },\n
+        \   \"spouse-relationships-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/spouse-relationships{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET\",\n      \"title\" : \"Person Relationships\"\n    },\n
+        \   \"person-discussion-references-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/discussion-references{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Discussion References\"\n
+        \   },\n    \"ancestry-query\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/ancestry{?access_token,person,spouse}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Ancestry\"\n    },\n    \"current-user\" : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/users/current\",\n
+        \     \"title\" : \"Current User\"\n    },\n    \"discussion-template\" :
+        {\n      \"template\" : \"https://sandbox.familysearch.org/platform/discussions/discussions/{did}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE\",\n      \"title\" : \"Discussion\"\n
+        \   },\n    \"discussion-comments-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/discussions/discussions/{did}/comments{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Comments\"\n    },\n
+        \   \"person-source-reference-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/source-references/{srid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Source Reference\"\n    },\n
+        \   \"couple-relationship-source-references-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/source-references{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Source References\"\n
+        \   },\n    \"child-and-parents-relationship-source-references-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/source-references{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Child-and-Parents Source
+        References\"\n    },\n    \"person-matches-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/matches{?access_token}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Matches\"\n    },\n    \"parent-relationships-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/parent-relationships{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Relationships\"\n    },\n    \"person-matches-query\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/matches{?access_token,count,q}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Matches Query\"\n    },\n    \"child-and-parents-relationships\"
+        : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships\",\n
+        \     \"title\" : \"Child-and-Parents Relationships\"\n    },\n    \"person-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE,GET,POST\",\n      \"title\" : \"Person\"\n
+        \   },\n    \"source-folder-descriptions-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/sources/folders/{sfid}/descriptions{?access_token,count,start}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Source Descriptions in
+        a Folder\"\n    },\n    \"authorities\" : {\n      \"href\" : \"https://sandbox.familysearch.org/authorities\"\n
+        \   },\n    \"reservation\" : {\n      \"href\" : \"https://sandbox.familysearch.org/reservation\"\n
+        \   },\n    \"person-changes-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/changes{?access_token}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Change History\"\n    },\n    \"fs-identity-v2-login\" : {\n      \"href\"
+        : \"https://sandbox.familysearch.org/identity/v2/login\"\n    },\n    \"preferred-spouse-relationship-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/users/{uid}/preferred-spouse-relationships/{pid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,DELETE,PUT\",\n      \"title\" : \"Preferred
+        Relationship\"\n    },\n    \"descendancy-query\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/descendancy{?access_token,person,spouse}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Descendancy\"\n    },\n    \"couple-relationship-notes-template\" : {\n
+        \     \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/notes{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Notes\"\n    },\n    \"folders\"
+        : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/sources/folders\",\n
+        \     \"title\" : \"Source Folders\"\n    },\n    \"source-folder-descriptions-trashbin-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/sources/folders/{sfid}/descriptions/trashbin{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"POST\",\n      \"title\" : \"Trashbin for Source Descriptions
+        in a Folder\"\n    },\n    \"child-and-parents-relationship-restore-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/restore{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"POST\",\n      \"title\" : \"Restore\"\n    },\n    \"fs-parent-relationships-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/fs-parent-relationships{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"FamilySearch Person Relationships\"\n    },\n    \"http://oauth.net/core/2.0/endpoint/token\"
+        : {\n      \"href\" : \"https://sandbox.familysearch.org/cis-web/oauth2/v3/token\"\n
+        \   },\n    \"http://oauth.net/core/2.0/endpoint/authorize\" : {\n      \"href\"
+        : \"https://sandbox.familysearch.org/cis-web/oauth2/v3/authorization\"\n    },\n
+        \   \"person-merge-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/merges/{dpid}{?access_token,filter}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"OPTIONS,GET,POST\",\n      \"title\" : \"Person Merge\"\n
+        \   },\n    \"person-source-references-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/source-references{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Source References\"\n
+        \   },\n    \"user-source-folders-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/sources/{uid}/folders{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET\",\n      \"title\" : \"User Source Folders\"\n    },\n
+        \   \"discussion-comment-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/discussions/discussions/{did}/comments/{cmid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Comment\"\n    },\n    \"person-with-relationships-query\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons-with-relationships{?access_token,person}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person With Relationships\"\n    },\n    \"child-and-parents-relationship-note-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/notes/{nid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST,DELETE\",\n      \"title\" : \"Note\"\n    },\n
+        \   \"change-restore-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/changes/{chid}/restore{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"POST\",\n      \"title\" : \"Restore\"\n    },\n    \"preferred-parent-relationship-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/users/{uid}/preferred-parent-relationships/{pid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,DELETE,PUT\",\n      \"title\" : \"Preferred
+        Relationship\"\n    },\n    \"person-note-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/notes/{nid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"GET,POST,DELETE\",\n      \"title\" : \"Note\"\n    },\n
+        \   \"child-and-parents-relationship-changes-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/changes{?access_token}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Change History\"\n    },\n    \"child-and-parents-relationship-notes-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/notes{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST\",\n      \"title\" : \"Child-and-Parents Notes\"\n
+        \   },\n    \"registration\" : {\n      \"href\" : \"https://sandbox.familysearch.org/cis-web/pages/registration/registration.html\"\n
+        \   },\n    \"persons\" : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons\",\n
+        \     \"title\" : \"Persons\"\n    },\n    \"person-search\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/search{?access_token,context,count,q,start}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Search\"\n    },\n    \"fs-identity-v2-permission\" : {\n      \"href\"
+        : \"https://sandbox.familysearch.org/identity/v2/permission\"\n    },\n    \"couple-relationship-restore-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/restore{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"POST\",\n      \"title\" : \"Restore\"\n    },\n    \"source-folder-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/sources/folders/{sfid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"GET,POST,DELETE\",\n      \"title\" : \"Source Box Folder\"\n
+        \   },\n    \"child-relationships-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/child-relationships{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Person Relationships\"\n    },\n    \"couple-relationship-changes-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}/changes{?access_token}\",\n
+        \     \"type\" : \"application/atom+xml,application/json,application/x-gedcomx-atom+json,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Change History\"\n    },\n    \"agent-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/users/agents/{uid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"Agent\"\n    },\n    \"child-and-parents-relationship-parent-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/{role}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Parent Relationship Role\"\n
+        \   },\n    \"fs-identity-v2-logout\" : {\n      \"href\" : \"https://sandbox.familysearch.org/identity/v2/logout\"\n
+        \   },\n    \"fs-child-relationships-template\" : {\n      \"template\" :
+        \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/fs-child-relationships{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"*/*\",\n      \"allow\" : \"GET\",\n      \"title\" :
+        \"FamilySearch Person Relationships\"\n    },\n    \"parent-child-relationship-template\"
+        : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/parent-child-relationships/{caprid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE,GET,POST\",\n      \"title\" : \"Relationship\"\n
+        \   },\n    \"person-discussion-reference-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/discussion-references/{drid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Discussion Reference\"\n
+        \   },\n    \"person-conclusion-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/persons/{pid}/conclusions/{cid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Conclusion\"\n    },\n
+        \   \"child-and-parents-relationship-source-reference-template\" : {\n      \"template\"
+        : \"https://sandbox.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}/source-references/{srid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml\",\n
+        \     \"allow\" : \"DELETE\",\n      \"title\" : \"Child-and-Parents Source
+        Reference\"\n    },\n    \"couple-relationships\" : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships\",\n
+        \     \"title\" : \"Relationships\"\n    },\n    \"source-descriptions\" :
+        {\n      \"href\" : \"https://sandbox.familysearch.org/platform/sources/descriptions\",\n
+        \     \"title\" : \"Source Descriptions\"\n    },\n    \"current-user-person\"
+        : {\n      \"href\" : \"https://sandbox.familysearch.org/platform/tree/current-person\",\n
+        \     \"title\" : \"Current User Person\"\n    },\n    \"fs-identity-v2-session\"
+        : {\n      \"href\" : \"https://sandbox.familysearch.org/identity/v2/session\"\n
+        \   },\n    \"couple-relationship-template\" : {\n      \"template\" : \"https://sandbox.familysearch.org/platform/tree/couple-relationships/{crid}{?access_token}\",\n
+        \     \"type\" : \"application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml,application/xml,text/html\",\n
+        \     \"accept\" : \"application/x-fs-v1+json,application/x-fs-v1+xml,application/x-gedcomx-v1+json,application/x-gedcomx-v1+xml\",\n
+        \     \"allow\" : \"HEAD,GET,POST,DELETE,GET,POST\",\n      \"title\" : \"Relationship\"\n
+        \   }\n  }\n}"
+    http_version: 
+  recorded_at: Tue, 26 Mar 2013 15:16:59 GMT
+- request:
+    method: get
+    uri: https://api-user-1241:1782@sandbox.familysearch.org/identity/v2/login?dataFormat=application/json&key=WCQY-7J1Q-GKVV-7DNM-SQ5M-9Q5H-JX3H-CMJK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/x-fs-v1+json
+      User-Agent:
+      - Faraday v0.8.7
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: !binary |-
+        T0s=
+    headers:
+      !binary "U2VydmVy":
+      - !binary |-
+        QXBhY2hlLUNveW90ZS8xLjE=
+      !binary "QXBwLVN2ci1JZA==":
+      - !binary |-
+        MTAwLi0yOQ==
+      !binary "UHJhZ21h":
+      - !binary |-
+        bm8tY2FjaGU=
+      !binary "RXhwaXJlcw==":
+      - !binary |-
+        VGh1LCAwMSBKYW4gMTk3MCAwMDowMDowMCBHTVQ=
+      !binary "Q2FjaGUtQ29udHJvbA==":
+      - !binary |-
+        bm8tY2FjaGU=
+      - !binary |-
+        bm8tc3RvcmU=
+      !binary "U2V0LUNvb2tpZQ==":
+      - !binary |-
+        ZnNzZXNzaW9uaWQ9VVNZU0MxMzIwQ0JCOTdFOTY4OTZFMTUzRTU2MzFGQkNF
+        MEM3X25iY2ktMDQ1LTAzNC5kLnVzeXMuZnNnbG9iYWwubmV0OyBQYXRoPS8=
+      !binary "WC1Qcm9jZXNzaW5nLVRpbWU=":
+      - !binary |-
+        MjExNQ==
+      !binary "Q29udGVudC1FbmNvZGluZw==":
+      - !binary |-
+        Z3ppcA==
+      !binary "Q29udGVudC1UeXBl":
+      - !binary |-
+        YXBwbGljYXRpb24vanNvbjtjaGFyc2V0PXV0Zi04
+      !binary "Q29udGVudC1MYW5ndWFnZQ==":
+      - !binary |-
+        ZW4tVVM=
+      !binary "Q29udGVudC1MZW5ndGg=":
+      - !binary |-
+        MTkw
+      !binary "RGF0ZQ==":
+      - !binary |-
+        VHVlLCAyNiBNYXIgMjAxMyAxNToxNzowMyBHTVQ=
+      !binary "Q29ubmVjdGlvbg==":
+      - !binary |-
+        Y2xvc2U=
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        H4sIAAAAAAAAADWNywrCMBBF/yVrGyZJH9ZlQ92IuBAXriTasQZKWjqJUIr/
+        bnwUZnMP98ydGXnjA+m+QbaRAKs/2CORaSNjhx1bINu40HUr1uAw4s14bBby
+        xJFs72Jd8oJLEOpzHBTIaJvgH+i8jcq39HMoTnzjzGx8xE7H81ELJUFXVVnU
+        Zb4u81pkqs5yJbaVrkEXF3e92QTSLAGV8oYHmojfqe36q+m4Qx/X/DTgb+P1
+        egNUEvgU4AAAAA==
+    http_version: 
+  recorded_at: Tue, 26 Mar 2013 15:17:01 GMT
+- request:
+    method: get
+    uri: https://sandbox.familysearch.org/platform/tree/current-person
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/x-fs-v1+json
+      User-Agent:
+      - Faraday v0.8.7
+      Authorization:
+      - Bearer USYSC1320CBB97E96896E153E5631FBCE0C7_nbci-045-034.d.usys.fsglobal.net
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 303
+      message: See Other
+    headers:
+      Server:
+      - Apache-Coyote/1.1
+      Location:
+      - https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99
+      Cache-Control:
+      - no-cache, no-store, no-transform, must-revalidate, max-age=0
+      X-Processing-Time:
+      - '57'
+      Content-Type:
+      - application/x-fs-v1+json
+      Content-Length:
+      - '0'
+      Date:
+      - Tue, 26 Mar 2013 15:17:03 GMT
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ''
+    http_version: 
+  recorded_at: Tue, 26 Mar 2013 15:17:02 GMT
+- request:
+    method: get
+    uri: https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/x-fs-v1+json
+      User-Agent:
+      - Faraday v0.8.7
+      Authorization:
+      - Bearer USYSC1320CBB97E96896E153E5631FBCE0C7_nbci-045-034.d.usys.fsglobal.net
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Apache-Coyote/1.1
+      Last-Modified:
+      - Thu, 05 Jul 2012 14:53:55 GMT
+      Etag:
+      - W/"880e71cc487ea5c0b06dd149ec388779b98d2297"
+      Content-Location:
+      - /platform/tree/persons/KW3B-N99
+      Cache-Control:
+      - no-transform, max-age=3600
+      X-Processing-Time:
+      - '45'
+      Content-Type:
+      - application/x-fs-v1+json
+      Transfer-Encoding:
+      - chunked
+      Date:
+      - Tue, 26 Mar 2013 15:17:04 GMT
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"persons\" : [ {\n    \"links\" : {\n      \"ancestry\" : {\n
+        \       \"href\" : \"https://sandbox.familysearch.org/platform/tree/ancestry?person=KW3B-N99\",\n
+        \       \"title\" : \"Ancestry\"\n      },\n      \"fs-child-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/fs-child-relationships\",\n
+        \       \"title\" : \"FamilySearch Person Relationships\"\n      },\n      \"person\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99\",\n
+        \       \"title\" : \"Person\"\n      },\n      \"descendancy\" : {\n        \"href\"
+        : \"https://sandbox.familysearch.org/platform/tree/descendancy?person=KW3B-N99\",\n
+        \       \"title\" : \"Descendancy\"\n      },\n      \"discussion-references\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/discussion-references\",\n
+        \       \"title\" : \"Discussion References\"\n      },\n      \"person-with-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons-with-relationships?person=KW3B-N99\",\n
+        \       \"title\" : \"Person With Relationships\"\n      },\n      \"change-history\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/changes\",\n
+        \       \"title\" : \"Change History\"\n      },\n      \"fs-parent-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/fs-parent-relationships\",\n
+        \       \"title\" : \"FamilySearch Person Relationships\"\n      },\n      \"spouse-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/spouse-relationships\",\n
+        \       \"title\" : \"Person Relationships\"\n      },\n      \"child-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/child-relationships\",\n
+        \       \"title\" : \"Person Relationships\"\n      },\n      \"parent-relationships\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/parent-relationships\",\n
+        \       \"title\" : \"Person Relationships\"\n      },\n      \"source-references\"
+        : {\n        \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/source-references\",\n
+        \       \"title\" : \"Source References\"\n      },\n      \"notes\" : {\n
+        \       \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/notes\",\n
+        \       \"title\" : \"Notes\"\n      },\n      \"person-matches\" : {\n        \"href\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/matches\",\n
+        \       \"title\" : \"Person Matches\"\n      }\n    },\n    \"id\" : \"KW3B-N99\",\n
+        \   \"living\" : true,\n    \"gender\" : {\n      \"links\" : {\n        \"conclusion\"
+        : {\n          \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/conclusions/C.1\",\n
+        \         \"title\" : \"Conclusion\"\n        }\n      },\n      \"id\" :
+        \"C.1\",\n      \"type\" : \"http://gedcomx.org/Male\"\n    },\n    \"names\"
+        : [ {\n      \"links\" : {\n        \"conclusion\" : {\n          \"href\"
+        : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/conclusions/C.2\",\n
+        \         \"title\" : \"Conclusion\"\n        }\n      },\n      \"id\" :
+        \"C.2\",\n      \"type\" : \"http://gedcomx.org/BirthName\",\n      \"nameForms\"
+        : [ {\n        \"lang\" : \"i-default\",\n        \"fullText\" : \"API User
+        1241\",\n        \"parts\" : [ {\n          \"type\" : \"http://gedcomx.org/Given\",\n
+        \         \"value\" : \"API User\"\n        }, {\n          \"type\" : \"http://gedcomx.org/Surname\",\n
+        \         \"value\" : \"1241\"\n        } ]\n      } ],\n      \"preferred\"
+        : true\n    } ],\n    \"facts\" : [ {\n      \"links\" : {\n        \"conclusion\"
+        : {\n          \"href\" : \"https://sandbox.familysearch.org/platform/tree/persons/KW3B-N99/conclusions/C.3\",\n
+        \         \"title\" : \"Conclusion\"\n        }\n      },\n      \"id\" :
+        \"C.3\",\n      \"type\" : \"http://gedcomx.org/Birth\",\n      \"date\" :
+        {\n        \"original\" : \"01 Apr 1950\",\n        \"formal\" : \"+1950-04-01\",\n
+        \       \"normalized\" : [ {\n          \"value\" : \"1 April 1950\"\n        }
+        ]\n      },\n      \"place\" : {\n        \"original\" : \"Utah\",\n        \"description\"
+        : \"#-1013587259\"\n      }\n    } ],\n    \"display\" : {\n      \"name\"
+        : \"API User 1241\",\n      \"gender\" : \"Male\",\n      \"lifespan\" : \"1950
+        - \",\n      \"birthDate\" : \"1 April 1950\",\n      \"birthPlace\" : \"Utah\"\n
+        \   }\n  } ],\n  \"places\" : [ {\n    \"id\" : \"-1013587259\",\n    \"names\"
+        : [ {\n      \"value\" : \"Utah, United States\"\n    } ]\n  } ]\n}"
+    http_version: 
+  recorded_at: Tue, 26 Mar 2013 15:17:02 GMT
+recorded_with: VCR 2.4.0