onfido 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f5ff31b07bd57afd22994fbf3cdca9b87a445f48
-  data.tar.gz: 725b94b57bb42062a18dc181996275b5e70c511a
+  metadata.gz: 9a1f27eb9ad0741dbb6a79a47e5500a9803949e3
+  data.tar.gz: 9b372d911abceaf82a67ffa26acf94b1f39043b0
 SHA512:
-  metadata.gz: 86a378c7321ddedea578b7576dbff36af63bcf6ec00bce990fd17dd3c52661aa07ec5a66584185b9617eab4517310244b398d4c0ec3f7cf7d767d7cb852de60b
-  data.tar.gz: 5845d5e243a8d759d4651e9b13325155ac515ba7097fbc7d77182c945c5533808372ed8c613d4ed1026afdc091b5aeb7d3027df561b41fb7b2444b52edc34a8e
+  metadata.gz: 64ec8d066f5c1001fa0ead05077135edff853704d2a36d80051da66825372df75fae278cff76cd29cdacb3bd217e71eb6a794137419c32854a653c3e71c78160
+  data.tar.gz: 020226ac91a091febf4039c3e0bde9adb0091163ec135f3f146b98a45d2c0b294788103294954cbaa18e3a48b2824969fe8db6f002a15d539d363c271de6e93a

data/.gitignore

@@ -2,6 +2,7 @@
 *.rbc
 .bundle
 .config
+.DS_Store
 .rspec
 .yardoc
 Gemfile.lock

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.4.0, 12 May 2016
+
+- BREAKING: target v2 of the Onfido API. To continue using v1, specify this
+  version in `Onfido.configure`
+- Add `api_version` configuration option
+  (see https://github.com/hvssle/onfido#configuration)
+- Add support for `Onfido::LivePhoto` resource
+
 ## v0.3.0, 16 March 2016
 
 - Add support for `Onfido::Webhook` resource

data/README.md

@@ -1,13 +1,11 @@
 # Onfido
 
-A wrapper for Onfido's [API](https://onfido.com/documentation#introduction). You should always refer to the documentation for valid API calls.
+A thin wrapper for Onfido's API.
 
 [![Gem Version](https://badge.fury.io/rb/onfido.svg)](http://badge.fury.io/rb/onfido)
 [![Build Status](https://travis-ci.org/hvssle/onfido.svg?branch=master)](https://travis-ci.org/hvssle/onfido)
 
-
-  [1]: https://gitter.im/hvssle/onfido
-  [2]: https://badges.gitter.im/gitterHQ/developers.png
+This gem supports both `v1` and `v2` of the Onfido API. Refer to Onfido's [API documentation](https://onfido.com/documentation#introduction) for details of the expected requests and responses for both.
 
 ## Installation
 
@@ -17,134 +15,117 @@ Add this line to your application's Gemfile:
 gem 'onfido'
 ```
 
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
+## Configuration
 
-    $ gem install onfido
-
-
-## Usage
-
-There are 4 configuration options for Onfido, including your `api_key`, timeout details and logging.
+There are 5 configuration options:
 
 ```ruby
-  Onfido.configure do |config|
-    config.api_key = 'MY_API_KEY'
-    config.logger = Logger.new(STDOUT)
-    config.open_timeout = 30
-    config.read_timeout = 80
-  end
+Onfido.configure do |config|
+  config.api_key = 'MY_API_KEY'
+  config.api_version = 'v2'
+  config.logger = Logger.new(STDOUT)
+  config.open_timeout = 30
+  config.read_timeout = 80
+end
 ```
 
-Assuming you have a valid key, you can conveniently make API calls by using an instance of the `API` class.
+## Usage
+
+You can make API calls by using an instance of the `API` class:
 
 ```ruby
-  api = Onfido::API.new
+api = Onfido::API.new
 ```
 
-### Making calls to Onfido's resources
+### Resources
 
-All resources share the same interface when making API calls. For creating a resource you can use `.create`, for finding one `.find` and for fetching all records for a resource `.all`.
+All resources share the same interface when making API calls. Use `.create` to create a resource, `.find` to find one, and `.all` to fetch all resources.
 
 **Note:** *All param keys should be a symbol e.g. `{ type: 'express', reports: [{ name: 'identity' }] }`*
 
+#### Applicants
 
-### Applicant
-
-To create an applicant, you can simply use
+Applicants are the object upon which Onfido checks are performed.
 
 ```ruby
-  api.applicant.create(params)
+api.applicant.create(params)          # => Creates an applicant
+api.applicant.find('applicant_id')    # => Finds a single applicant
+api.applicant.all                     # => Returns all applicants
 ```
 
-To find an existing applicant
-
-```ruby
-  api.applicant.find('applicant_id')
-```
+#### Documents
 
-To get all applicants
+Documents provide supporting evidence for Onfido checks. They can only be
+created - the Onfido does not support finding or listing them.
 
 ```ruby
-  api.applicant.all
+api.document.create('applicant_id', file: 'http://example.com', type: 'passport')
 ```
 
-### Document
+**Note:** The file parameter can be either a `File` object or a link to an image.
 
-To upload a document for an applicant, you can simply use
+#### Live Photos
 
-```ruby
-  api.document.create('applicant_id', file: 'http://example.com', type: 'passport')
-```
-
-The file can both be a `File` object or a link to an image.
-
-### Check
-
-To create a check for an applicant, you can simply use
+Live Photos, like documents, can provide supporting evidence for Onfido checks.
+They can only be created - the Onfido does not support finding or listing them.
 
 ```ruby
-  api.check.create('applicant_id', type: 'express', reports: [{ name: 'identity' }])
+api.live_photo.create('applicant_id', file: 'http://example.com')
 ```
 
-To find an existing check for an applicant
+**Note:** The file parameter can be either a `File` object or a link to an image.
 
-```ruby
-  api.check.find('applicant_id', 'check_id')
-```
+#### Checks
 
-To get all checks for an applicant
+Checks are requests for Onfido to check an applicant, by commissioning one or
+more "reports" on them.
 
 ```ruby
-  api.check.all('applicant_id')
+api.check.create('applicant_id', type: 'express', reports: [{ name: 'identity' }])
+api.check.find('applicant_id', 'check_id')
+api.check.all('applicant_id')
 ```
 
-### Report
+#### Reports
 
-To find an existing report for a check
+Reports provide details of the results of some part of a "check". They are
+created when a check is created, so the Onfido API only provides support for
+finding and listing them.
 
 ```ruby
-  api.report.find('check_id', 'report_id')
+api.report.find('check_id', 'report_id')
+api.report.all('check_id')
 ```
 
-To get all reports for a check
+#### Address Lookups
+
+Onfido provides an address lookup service, to help ensure well-formatted
+addresses are provided when creating "applicants". To search for addresses
+by postcode, use:
 
 ```ruby
-  api.report.all('check_id')
+api.address.all('SE1 4NG')
 ```
 
-### Address Picker
+#### Webhook Endpoints
 
-To search for addresses by postcode
+Onfido allows you to set up and view your webhook endpoints via the API, as well
+as through the dashboard.
 
 ```ruby
-  api.address.all('SE1 4NG')
+api.webhook.create(params)          # => Creates a webhook endpoint
+api.webhook.find('webhook_id')      # => Finds a single webhook endpoint
+api.webhook.all                     # => Returns all webhook endpoints
 ```
 
 ### Pagination
 
-Currently, you can paginate over the *applicant* and *check* resources. However, since you can only create 1 check per applicant therefore paginating on the check resource might prove impractical.
-
-By default, both endpoints are fetching records the first 20 records. That is the maximum amount of records you can request per page.
-
-To paginate over *applicants*:
-```ruby
-api = Onfido::API.new
-api.applicant.all(page: 2, per_page: 10)
-```
-
-To paginate over *checks*:
-```
-api = Onfido::API.new
-api.check.all('applicant_id', page: 2, per_page: 10)
-```
+All resources that support an `all` method also support pagination. By default,
+the first 20 records are fetched.
 
-## Error Handling
+### Error Handling
 
-There are three classes of errors raised by the library, all of which subclass `Onfido::Error`.
+There are three classes of errors raised by the library, all of which subclass `Onfido::Error`:
 - `Onfido::ServerError` is raised whenever Onfido returns a `5xx` response
 - `Onfido::RequestError` is raised whenever Onfido returns any other kind of error
 - `Onfido::ConnectionError` is raised whenever a network error occurs (e.g., a timeout)
@@ -152,20 +133,20 @@ There are three classes of errors raised by the library, all of which subclass `
 All three error classes provide the `response_code`, `response_body`, `json_body`, `type` and `fields` of the error (although for `Onfido::ServerError` and `Onfido::ConnectionError` the last three are likely to be `nil`).
 
 ```ruby
-  def create_applicant
-    api.applicant.create(params)
-  rescue Onfido::RequestError => e
-    e.type          # => 'validation_error'
-    e.fields        # => { "email": { "messages": ["invalid format"] } }
-    e.response_code # => '422'
-  end
+def create_applicant
+  api.applicant.create(params)
+rescue Onfido::RequestError => e
+  e.type          # => 'validation_error'
+  e.fields        # => { "email": { "messages": ["invalid format"] } }
+  e.response_code # => '422'
+end
 ```
 
-### Roadmap
+## Roadmap
 
 - Improve test coverage with more scenarios
-- Add custom errors based on the response code.
-- Improve documentation
+- Add custom errors based on the response code
+- Improve pagination handling (use information passed in link header)
 
 ## Contributing
 

data/lib/onfido/configuration.rb

@@ -1,6 +1,6 @@
 module Onfido
   module Configuration
-    attr_accessor :api_key, :open_timeout, :read_timeout
+    attr_accessor :api_key, :open_timeout, :read_timeout, :api_version
 
     def self.extended(base)
       base.reset
@@ -14,6 +14,7 @@ module Onfido
       self.api_key = nil
       self.open_timeout = 30
       self.read_timeout = 80
+      self.api_version = 'v2'
       RestClient.log = nil
     end
 
@@ -30,7 +31,7 @@ module Onfido
     end
 
     def endpoint
-      'https://api.onfido.com/v1/'
+      "https://api.onfido.com/#{api_version}/"
     end
   end
 end

data/lib/onfido/resource.rb

@@ -11,7 +11,7 @@ module Onfido
         make_request(
           method: method.to_sym,
           url: args.first.fetch(:url),
-          payload: build_query(args.first.fetch(:payload))
+          payload: build_query(args.first.fetch(:payload, {}))
         )
       end
     end
@@ -35,14 +35,14 @@ module Onfido
       response = RestClient::Request.execute(request_options)
 
       parse(response)
-    rescue RestClient::ExceptionWithResponse => e
-      if e.response
-        handle_api_error(e.response)
+    rescue RestClient::ExceptionWithResponse => error
+      if error.response
+        handle_api_error(error.response)
       else
-        handle_restclient_error(e, url)
+        handle_restclient_error(error, url)
       end
-    rescue RestClient::Exception, Errno::ECONNREFUSED => e
-      handle_restclient_error(e, url)
+    rescue RestClient::Exception, Errno::ECONNREFUSED => error
+      handle_restclient_error(error, url)
     end
 
     def parse(response)
@@ -97,13 +97,13 @@ module Onfido
       )
     end
 
-    def handle_restclient_error(e, url)
+    def handle_restclient_error(error, url)
       connection_message =
         "Please check your internet connection and try again. " \
         "If this problem persists, you should let us know at info@onfido.com."
 
       message =
-        case e
+        case error
         when RestClient::RequestTimeout
           "Could not connect to Onfido (#{url}). #{connection_message}"
 
@@ -127,7 +127,7 @@ module Onfido
           "If this problem persists, let us know at info@onfido.com."
         end
 
-      full_message = message + "\n\n(Network error: #{e.message})"
+      full_message = message + "\n\n(Network error: #{error.message})"
 
       raise ConnectionError.new(full_message)
     end

data/lib/onfido/resources/applicant.rb

@@ -0,0 +1,15 @@
+module Onfido
+  class Applicant < Resource
+    def create(payload)
+      post(url: url_for('applicants'), payload: payload)
+    end
+
+    def find(applicant_id)
+      get(url: url_for("applicants/#{applicant_id}"))
+    end
+
+    def all(page: 1, per_page: 20)
+      get(url: url_for("applicants?page=#{page}&per_page=#{per_page}"))
+    end
+  end
+end

data/lib/onfido/{check.rb → resources/check.rb}

@@ -8,18 +8,12 @@ module Onfido
     end
 
     def find(applicant_id, check_id)
-      get(
-        url: url_for("applicants/#{applicant_id}/checks/#{check_id}"),
-        payload: {}
-      )
+      get(url: url_for("applicants/#{applicant_id}/checks/#{check_id}"))
     end
 
     def all(applicant_id, page: 1, per_page: 20)
       querystring = "page=#{page}&per_page=#{per_page}"
-      get(
-        url: url_for("applicants/#{applicant_id}/checks?#{querystring}"),
-        payload: {}
-      )
+      get(url: url_for("applicants/#{applicant_id}/checks?#{querystring}"))
     end
   end
 end

data/lib/onfido/resources/live_photo.rb

@@ -0,0 +1,13 @@
+module Onfido
+  class LivePhoto < Resource
+    # with open-uri the file can be a link or an actual file
+
+    def create(applicant_id, payload)
+      payload[:file] = open(payload.fetch(:file), 'r')
+      post(
+        url: url_for("applicants/#{applicant_id}/live_photos"),
+        payload: payload
+      )
+    end
+  end
+end

data/lib/onfido/resources/report.rb

@@ -0,0 +1,12 @@
+module Onfido
+  class Report < Resource
+    def find(check_id, report_id)
+      get(url: url_for("checks/#{check_id}/reports/#{report_id}"))
+    end
+
+    def all(check_id, page: 1, per_page: 20)
+      querystring = "page=#{page}&per_page=#{per_page}"
+      get(url: url_for("checks/#{check_id}/reports?#{querystring}"))
+    end
+  end
+end

data/lib/onfido/resources/webhook.rb

@@ -0,0 +1,18 @@
+module Onfido
+  class Webhook < Resource
+    def create(payload)
+      post(
+        url: url_for('webhooks'),
+        payload: payload
+      )
+    end
+
+    def find(webhooks_id)
+      get(url: url_for("webhooks/#{webhooks_id}"))
+    end
+
+    def all(page: 1, per_page: 20)
+      get(url: url_for("webhooks?page=#{page}&per_page=#{per_page}"))
+    end
+  end
+end

data/lib/onfido/version.rb

@@ -1,3 +1,3 @@
 module Onfido
-  VERSION = '0.3.0'.freeze
+  VERSION = '0.4.0'.freeze
 end

data/lib/onfido.rb

@@ -10,14 +10,15 @@ require 'onfido/errors/request_error'
 require 'onfido/errors/server_error'
 require 'onfido/errors/connection_error'
 require 'onfido/null_logger'
-require 'onfido/resource'
-require 'onfido/address'
-require 'onfido/applicant'
-require 'onfido/document'
-require 'onfido/check'
-require 'onfido/report'
-require 'onfido/webhook'
 require 'onfido/api'
+require 'onfido/resource'
+require 'onfido/resources/address'
+require 'onfido/resources/applicant'
+require 'onfido/resources/check'
+require 'onfido/resources/document'
+require 'onfido/resources/live_photo'
+require 'onfido/resources/report'
+require 'onfido/resources/webhook'
 
 module Onfido
   extend Configuration

data/spec/integrations/applicant_spec.rb

@@ -43,7 +43,7 @@ describe Onfido::Applicant do
 
     it 'serializes the payload correctly' do
       WebMock.after_request do |request_signature, _response|
-        if request_signature.uri.path == 'v1/applicants'
+        if request_signature.uri.path == 'v2/applicants'
           expect(Rack::Utils.parse_nested_query(request_signature.body)).
             to eq(params)
         end

data/spec/integrations/live_photo_spec.rb

@@ -0,0 +1,22 @@
+require 'tempfile'
+
+describe Onfido::LivePhoto do
+  subject(:live_photo) { described_class.new }
+
+  describe '#create' do
+    after do
+      file.close
+      file.unlink
+    end
+
+    let(:file) { Tempfile.new(['photo', '.jpg']) }
+    before { allow(live_photo).to receive(:open).and_return(:file) }
+    let(:params) { { file: file } }
+    let(:applicant_id) { '1030303-123123-123123' }
+
+    it 'creates a new photo' do
+      response = live_photo.create('foobar', params)
+      expect(response['id']).not_to be_nil
+    end
+  end
+end

data/spec/integrations/webhook_spec.rb

@@ -25,6 +25,15 @@ describe Onfido::Webhook do
     end
   end
 
+  describe '#find' do
+    let(:webhook_id) { 'fcb73186-0733-4f6f-9c57-d9d5ef979443' }
+
+    it 'returns the webhook' do
+      response = webhook.find(webhook_id)
+      expect(response['id']).to eq(webhook_id)
+    end
+  end
+
   describe "#all" do
     it "returns all the registered webhooks" do
       response = webhook.all

data/spec/onfido/resource_spec.rb

@@ -1,6 +1,6 @@
 describe Onfido::Resource do
   subject(:resource) { described_class.new }
-  let(:endpoint) { 'https://api.onfido.com/v1/' }
+  let(:endpoint) { 'https://api.onfido.com/v2/' }
   let(:path) { 'addresses/pick' }
   let(:api_key) { 'some_key' }
 

data/spec/onfido_spec.rb

@@ -1,9 +1,8 @@
 describe Onfido do
   subject(:onfido) { described_class }
+  after(:each) { onfido.reset }
 
   context 'configuration' do
-    before { onfido.reset }
-
     describe "default values" do
       describe ".api_key" do
         subject { onfido.api_key }
@@ -12,7 +11,7 @@ describe Onfido do
 
       describe ".endpoint" do
         subject { onfido.endpoint }
-        it { is_expected.to eq('https://api.onfido.com/v1/') }
+        it { is_expected.to eq('https://api.onfido.com/v2/') }
       end
 
       describe ".logger" do
@@ -28,6 +27,14 @@ describe Onfido do
       end
     end
 
+    describe "setting the API version" do
+      it 'changes the configuration to the new value' do
+        onfido.api_version = 'v1'
+        expect(onfido.api_version).to eq('v1')
+        expect(onfido.endpoint).to eq('https://api.onfido.com/v1/')
+      end
+    end
+
     describe '.logger' do
       context 'when an option is passed' do
         context 'when the option passed behaves like a logger' do

data/spec/support/fake_onfido_api.rb

@@ -1,66 +1,73 @@
 require 'sinatra/base'
 
 class FakeOnfidoAPI < Sinatra::Base
-  get '/v1/addresses/pick' do
+  get '/v2/addresses/pick' do
     json_response(200, 'addresses.json')
   end
 
-  post '/v1/applicants' do
+  post '/v2/applicants' do
     json_response(201, 'applicant.json')
   end
 
-  get '/v1/applicants/:id' do
+  get '/v2/applicants/:id' do
     json_response(200, 'applicant.json')
   end
 
-  get '/v1/applicants' do
+  get '/v2/applicants' do
     response = json_response(200, 'applicants.json')
     { applicants: JSON.parse(response)['applicants'][pagination_range] }.to_json
   end
 
-  post '/v1/applicants/:id/documents' do
+  post '/v2/applicants/:id/documents' do
     json_response(201, 'document.json')
   end
 
-  post '/v1/applicants/:id/checks' do
+  post '/v2/applicants/:id/live_photos' do
+    json_response(201, 'live_photo.json')
+  end
+
+  post '/v2/applicants/:id/checks' do
     json_response(201, 'check.json')
   end
 
-  get '/v1/applicants/:id/checks/:id' do
+  get '/v2/applicants/:id/checks/:id' do
     json_response(200, 'check.json')
   end
 
-  get '/v1/applicants/:id/checks' do
+  get '/v2/applicants/:id/checks' do
     response = json_response(200, 'checks.json')
     { checks: JSON.parse(response)['checks'][pagination_range] }.to_json
   end
 
-  get '/v1/checks/:id/reports' do
+  get '/v2/checks/:id/reports' do
     json_response(200, 'reports.json')
   end
 
-  get '/v1/checks/:id/reports/:id' do
+  get '/v2/checks/:id/reports/:id' do
     json_response(200, 'report.json')
   end
 
-  post '/v1/webhooks' do
+  post '/v2/webhooks' do
     json_response(201, 'webhook.json')
   end
 
-  get '/v1/webhooks' do
-    json_response(200, 'webhooks.json')
+  get '/v2/webhooks/:id' do
+    json_response(200, 'webhook.json')
   end
 
+  get '/v2/webhooks' do
+    json_response(200, 'webhooks.json')
+  end
 
-  get '/v1/4xx_response' do
+  get '/v2/4xx_response' do
     json_response(422, '4xx_response.json')
   end
 
-  get '/v1/unexpected_error_format' do
+  get '/v2/unexpected_error_format' do
     json_response(400, 'unexpected_error_format.json')
   end
 
-  get '/v1/unparseable_response' do
+  get '/v2/unparseable_response' do
     content_type :json
     status 504
     ''

data/spec/support/fixtures/applicant.json

@@ -11,7 +11,7 @@
     "telephone":"555555555",
     "mobile":"77777777",
     "country":"gbr",
-    "href":"/v1/applicants/61f659cb-c90b-4067-808a-6136b5c01351",
+    "href":"/v2/applicants/61f659cb-c90b-4067-808a-6136b5c01351",
     "id_numbers":[],
     "addresses": [
         {

data/spec/support/fixtures/check.json

@@ -1,7 +1,7 @@
 {
   "id": "8546921-123123-123123",
   "created_at": "2014-05-23T13:50:33Z",
-  "href": "/v1/applicants/61f659cb-c90b-4067-808a-6136b5c01351/checks/8546921-123123-123123",
+  "href": "/v2/applicants/61f659cb-c90b-4067-808a-6136b5c01351/checks/8546921-123123-123123",
   "type": "standard",
   "status": "pending",
   "result": "pending",
@@ -12,7 +12,7 @@
       "created_at": "2014-05-23T13:50:33Z",
       "status": "awaiting_applicant",
       "result": "pending",
-      "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-422221",
+      "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-422221",
       "breakdown": {},
       "properties": {}
     },
@@ -22,7 +22,7 @@
       "created_at": "2014-05-23T13:50:33Z",
       "status": "awaiting_applicant",
       "result": "pending",
-      "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-316712",
+      "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-316712",
       "breakdown": {},
       "properties": {}
     }

data/spec/support/fixtures/checks.json

@@ -3,7 +3,7 @@
         {
             "id": "8546921-123123-123123",
             "created_at": "2014-05-23T13:50:33Z",
-            "href": "/v1/applicants/61f659cb-c90b-4067-808a-6136b5c01351/checks/8546921-123123-123123",
+            "href": "/v2/applicants/61f659cb-c90b-4067-808a-6136b5c01351/checks/8546921-123123-123123",
             "type": "standard",
             "status": "pending",
             "result": "pending",
@@ -14,7 +14,7 @@
                     "created_at": "2014-05-23T13:50:33Z",
                     "status": "awaiting_applicant",
                     "result": "pending",
-                    "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-422221",
+                    "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-422221",
                     "breakdown": {},
                     "properties": {}
                 },
@@ -24,7 +24,7 @@
                     "created_at": "2014-05-23T13:50:33Z",
                     "status": "awaiting_applicant",
                     "result": "pending",
-                    "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-316712",
+                    "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-316712",
                     "breakdown": {},
                     "properties": {}
                 }

data/spec/support/fixtures/document.json

@@ -1,7 +1,7 @@
 {
   "id": "7568415-123123-123123",
   "created_at": "2014-05-23 13:50:33Z",
-  "href": "/v1/applicants/1030303-123123-123123/documents/7568415-123123-123123",
+  "href": "/v2/applicants/1030303-123123-123123/documents/7568415-123123-123123",
   "file_name": "passport.jpg",
   "file_type": "png",
   "file_size": 282870,

data/spec/support/fixtures/live_photo.json

@@ -0,0 +1,4 @@
+{
+  "id": "7410A943-8F00-43D8-98DE-36A774196D86",
+  "created_at": "2014-05-23 13:50:33Z"
+}

data/spec/support/fixtures/report.json

@@ -4,7 +4,7 @@
   "created_at": "2014-05-23T13:50:33Z",
   "status": "awaiting_applicant",
   "result": "pending",
-  "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-422221",
+  "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-422221",
   "breakdown": {},
   "properties": {}
 }

data/spec/support/fixtures/reports.json

@@ -6,7 +6,7 @@
       "created_at": "2014-05-23T13:50:33Z",
       "status": "awaiting_applicant",
       "result": "pending",
-      "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-422221",
+      "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-422221",
       "breakdown": {},
       "properties": {}
     },
@@ -16,7 +16,7 @@
       "created_at": "2014-05-23T13:50:33Z",
       "status": "awaiting_applicant",
       "result": "pending",
-      "href": "/v1/checks/8546921-123123-123123/reports/6951786-123123-316712",
+      "href": "/v2/checks/8546921-123123-123123/reports/6951786-123123-316712",
       "breakdown": {},
       "properties": {}
     }

data/spec/support/fixtures/webhook.json

@@ -3,7 +3,7 @@
   "url": "https://webhookendpoint.url",
   "token": "yV85IsmuYwmjQGlZ",
   "enabled": true,
-  "href": "/v1/webhooks/fcb73186-0733-4f6f-9c57-d9d5ef979443",
+  "href": "/v2/webhooks/fcb73186-0733-4f6f-9c57-d9d5ef979443",
   "events": [
     "report completion",
     "report withdrawal",

data/spec/support/fixtures/webhooks.json

@@ -3,7 +3,7 @@
     {
       "id": "dd0a89e4-d44e-417a-aec4-01137d01ae59",
       "url": "https://demo.com","enabled":false,
-      "href": "/v1/webhooks/dd0a89e4-d44e-417a-aec4-01137d01ae59",
+      "href": "/v2/webhooks/dd0a89e4-d44e-417a-aec4-01137d01ae59",
       "events":
       [
         "check in progress"
@@ -13,7 +13,7 @@
       "id": "bfc727a8-f7bf-4073-b123-ed70a70f58e5",
       "url": "https://demo2.com",
       "enabled": true,
-      "href": "/v1/webhooks/bfc727a8-f7bf-4073-b123-ed70a70f58e5",
+      "href": "/v2/webhooks/bfc727a8-f7bf-4073-b123-ed70a70f58e5",
       "events":
       [
           "report completion",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: onfido
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Pericles Theodorou
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-16 00:00:00.000000000 Z
+date: 2016-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -141,27 +141,29 @@ files:
 - README.md
 - Rakefile
 - lib/onfido.rb
-- lib/onfido/address.rb
 - lib/onfido/api.rb
-- lib/onfido/applicant.rb
-- lib/onfido/check.rb
 - lib/onfido/configuration.rb
-- lib/onfido/document.rb
 - lib/onfido/errors/connection_error.rb
 - lib/onfido/errors/onfido_error.rb
 - lib/onfido/errors/request_error.rb
 - lib/onfido/errors/server_error.rb
 - lib/onfido/null_logger.rb
-- lib/onfido/report.rb
 - lib/onfido/resource.rb
+- lib/onfido/resources/address.rb
+- lib/onfido/resources/applicant.rb
+- lib/onfido/resources/check.rb
+- lib/onfido/resources/document.rb
+- lib/onfido/resources/live_photo.rb
+- lib/onfido/resources/report.rb
+- lib/onfido/resources/webhook.rb
 - lib/onfido/version.rb
-- lib/onfido/webhook.rb
 - onfido.gemspec
 - spec/integrations/address_spec.rb
 - spec/integrations/applicant_spec.rb
 - spec/integrations/check_spec.rb
 - spec/integrations/document_spec.rb
 - spec/integrations/exceptions_spec.rb
+- spec/integrations/live_photo_spec.rb
 - spec/integrations/report_spec.rb
 - spec/integrations/webhook_spec.rb
 - spec/onfido/connection_error_spec.rb
@@ -177,6 +179,7 @@ files:
 - spec/support/fixtures/check.json
 - spec/support/fixtures/checks.json
 - spec/support/fixtures/document.json
+- spec/support/fixtures/live_photo.json
 - spec/support/fixtures/report.json
 - spec/support/fixtures/reports.json
 - spec/support/fixtures/unexpected_error_format.json
@@ -212,6 +215,7 @@ test_files:
 - spec/integrations/check_spec.rb
 - spec/integrations/document_spec.rb
 - spec/integrations/exceptions_spec.rb
+- spec/integrations/live_photo_spec.rb
 - spec/integrations/report_spec.rb
 - spec/integrations/webhook_spec.rb
 - spec/onfido/connection_error_spec.rb
@@ -227,6 +231,7 @@ test_files:
 - spec/support/fixtures/check.json
 - spec/support/fixtures/checks.json
 - spec/support/fixtures/document.json
+- spec/support/fixtures/live_photo.json
 - spec/support/fixtures/report.json
 - spec/support/fixtures/reports.json
 - spec/support/fixtures/unexpected_error_format.json

data/lib/onfido/applicant.rb

@@ -1,21 +0,0 @@
-module Onfido
-  class Applicant < Resource
-    def create(payload)
-      post(
-        url: url_for('applicants'),
-        payload: payload
-      )
-    end
-
-    def find(applicant_id)
-      get(url: url_for("applicants/#{applicant_id}"), payload: {})
-    end
-
-    def all(page: 1, per_page: 20)
-      get(
-        url: url_for("applicants?page=#{page}&per_page=#{per_page}"),
-        payload: {}
-      )
-    end
-  end
-end

data/lib/onfido/report.rb

@@ -1,11 +0,0 @@
-module Onfido
-  class Report < Resource
-    def find(check_id, report_id)
-      get(url: url_for("checks/#{check_id}/reports/#{report_id}"), payload: {})
-    end
-
-    def all(check_id)
-      get(url: url_for("checks/#{check_id}/reports"), payload: {})
-    end
-  end
-end

data/lib/onfido/webhook.rb

@@ -1,18 +0,0 @@
-module Onfido
-  class Webhook < Resource
-    def create(payload)
-      post(
-        url: url_for('webhooks'),
-        payload: payload
-      )
-    end
-
-    def all
-      get(
-        url: url_for("webhooks"),
-        payload: {}
-      )
-    end
-
-  end
-end