onfido 2.0.2 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7983a2913b8ae4c7a1e53d92b8b62028b57e6e05705f6e5cef13028e77d7a30d
-  data.tar.gz: e923fe60b61214229d3546868a82128607147fb462a7966552ebc67e5d1263e8
+  metadata.gz: 33080fe8a76369f014e7505bbc1597a6531f683374c958729f3a5aac6aa181c4
+  data.tar.gz: 35f3beb4faa5fc70b8c7f9e40418f8befa943a39ff0801403ebd2bc307a8bdbf
 SHA512:
-  metadata.gz: 2ab79a44f5d86fbb3fd17c56e3d876ce256f95f88508300d571ebd6a068973323082f7c1a32cf1edd44bbcec5351a073363c08d4950cae6e0510e54263cff448
-  data.tar.gz: a02418a2e5db122bf0fcf3bce2d5547033e4c8e71b18f7a39006674e0a55cd46fb658986224c6f025c3b028e8bac48d19370c903abaa41e874456420ab2c0bf2
+  metadata.gz: 3910d5775649dc5091b49e3417ce6b89962799786026cc0f829e8cca88e2e86ea720e01570dd3b32630776d5e4007d76ed5773d473c6616a14ab7fd64f3e0740
+  data.tar.gz: 1ea8c2e2a8147a207213d8ca41fa11c98c46393fcba383e242450621cd66210ac0edc0b464a75fa9c1328c136a4d34d49c9434d6aa22e651779989c05dc6ef0a

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## v2.2.0, 02 March 2022
+
+- Support Onfido API version 3.3
+
+## v2.1.1, 01 February 2022
+
+- Send params as json
+- Remove .travis.yml
+- Update README.md link
+
+## v2.1.0, 23 June 2021
+
+- Support Onfido API version 3.2
+
 ## v2.0.2, 10 June 2021
 
 - Add error coverage for errors RestClient:BadGateway

data/README.md

@@ -7,7 +7,7 @@ The official Ruby library for integrating with the Onfido API.
 
 Documentation can be found at https://documentation.onfido.com
 
-This version uses Onfido API v3.1 and is compatible with Ruby 2.4 onwards. Refer to our [API versioning guide](https://developers.onfido.com/guide/api-versioning-policy#client-libraries) for details of which client library versions use which versions of the API.
+This version uses Onfido API v3.3 and is compatible with Ruby 2.4 onwards. Refer to our [API versioning guide](https://developers.onfido.com/guide/api-versioning-policy#client-libraries) for details of which client library versions use which versions of the API.
 
 ## Installation
 
@@ -76,7 +76,7 @@ onfido = Onfido::API.new(
 
 ## Verifying webhooks
 
-Each webhook endpoint has a secret token, generated automatically and [exposed](https://onfido.com/documentation#register-webhook) in the API. When sending a request, Onfido includes a signature computed using the request body and this token in the `X-SHA2-Signature` header.
+Each webhook endpoint has a secret token, generated automatically and [exposed](https://documentation.onfido.com/#register-webhook) in the API. When sending a request, Onfido includes a signature computed using the request body and this token in the `X-SHA2-Signature` header.
 
 You should compare this provided signature to one you generate yourself with the token to verify that a webhook is a genuine request from Onfido.
 
@@ -90,7 +90,7 @@ else
 end
 ```
 
-Read more at https://onfido.com/documentation#webhook-security
+Read more at https://developers.onfido.com/guide/manual-webhook-signature-verification#webhook-security
 
 ## Contributing
 

data/lib/onfido/options.rb

@@ -32,7 +32,7 @@ module Onfido
     attr_reader :api_key, :open_timeout, :read_timeout
 
     def base_url
-      @unknown_api_url || "https://api.#{@region}.onfido.com/v3.1/"
+      @unknown_api_url || "https://api.#{@region}.onfido.com/v3.3/"
     end
   end
 end

data/lib/onfido/resource.rb

@@ -4,6 +4,7 @@ module Onfido
   class Resource # rubocop:todo Metrics/ClassLength
     VALID_HTTP_METHODS = %i[get post put delete].freeze
     REQUEST_TIMEOUT_HTTP_CODE = 408
+    ADDITIONAL_HEADERS = { 'Content-Type' => 'application/json; charset=utf-8' }.freeze
 
     def initialize(options)
       @rest_client = options.rest_client
@@ -14,19 +15,22 @@ module Onfido
     attr_reader :rest_client
 
     def get(path:)
-      handle_request { rest_client[path].get }
+      handle_request { rest_client[path].get(ADDITIONAL_HEADERS) }
     end
 
-    def post(path:, payload: nil)
-      handle_request { rest_client[path].post(payload) }
+    def post(path:, payload: nil, send_json: true)
+      parsed_payload = send_json ? payload.to_json : payload
+      additional_headers = send_json ? ADDITIONAL_HEADERS : {}
+
+      handle_request { rest_client[path].post(parsed_payload, additional_headers) }
     end
 
     def put(path:, payload: nil)
-      handle_request { rest_client[path].put(payload) }
+      handle_request { rest_client[path].put(payload.to_json, ADDITIONAL_HEADERS) }
     end
 
     def delete(path:)
-      handle_request { rest_client[path].delete }
+      handle_request { rest_client[path].delete(ADDITIONAL_HEADERS) }
     end
 
     def handle_request

data/lib/onfido/resources/document.rb

@@ -10,7 +10,7 @@ module Onfido
       payload[:file] = file
       payload[:type] = type
 
-      post(path: 'documents', payload: payload)
+      post(path: 'documents', payload: payload, send_json: false)
     end
 
     def find(document_id)

data/lib/onfido/resources/live_photo.rb

@@ -9,7 +9,7 @@ module Onfido
       payload[:applicant_id] = applicant_id
       payload[:file] = file
 
-      post(path: 'live_photos', payload: payload)
+      post(path: 'live_photos', payload: payload, send_json: false)
     end
 
     def find(live_photo_id)

data/lib/onfido/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Onfido
-  VERSION = '2.0.2'
+  VERSION = '2.2.0'
 end

data/spec/integrations/applicant_spec.rb

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

data/spec/onfido/options_spec.rb

@@ -26,7 +26,7 @@ describe Onfido::Options do
     end
 
     it 'configures with region' do
-      expect(rest_client.url).to eq 'https://api.us.onfido.com/v3.1/'
+      expect(rest_client.url).to eq 'https://api.us.onfido.com/v3.3/'
     end
 
     it 'configures with timeouts' do

data/spec/support/fake_onfido_api.rb

@@ -9,32 +9,42 @@ RSpec.shared_context 'fake onfido api' do
 end
 
 class FakeOnfidoAPI < Sinatra::Base # rubocop:disable Metrics/ClassLength
-  get '/v3.1/addresses/pick' do
+  before do
+    begin
+      if request.content_type == "application/json; charset=utf-8"
+        body_parameters = JSON.parse(request.body.read)
+        params.merge!(body_parameters) if body_parameters
+      end
+    rescue JSON::ParserError
+    end
+  end
+
+  get '/v3.3/addresses/pick' do
     json_response(200, 'addresses.json')
   end
 
-  post '/v3.1/applicants' do
+  post '/v3.3/applicants' do
     json_response(201, 'applicant.json')
   end
 
-  put '/v3.1/applicants/:id' do
+  put '/v3.3/applicants/:id' do
     json_response(200, 'applicant.json')
   end
 
-  get '/v3.1/applicants/:id' do
+  get '/v3.3/applicants/:id' do
     json_response(200, 'applicant.json')
   end
 
-  get '/v3.1/applicants' do
+  get '/v3.3/applicants' do
     response = json_response(200, 'applicants.json')
     { applicants: JSON.parse(response)['applicants'][pagination_range] }.to_json
   end
 
-  delete '/v3.1/applicants/:id' do
+  delete '/v3.3/applicants/:id' do
     status 204
   end
 
-  post '/v3.1/applicants/:id/restore' do
+  post '/v3.3/applicants/:id/restore' do
     if params['id'] == 'a2fb9c62-ab10-4898-a8ec-342c4b552ad5'
       json_response(422, 'not_scheduled_for_deletion_error.json')
     else
@@ -42,37 +52,37 @@ class FakeOnfidoAPI < Sinatra::Base # rubocop:disable Metrics/ClassLength
     end
   end
 
-  post '/v3.1/documents' do
+  post '/v3.3/documents' do
     json_response(201, 'document.json')
   end
 
-  post '/v3.1/extractions' do
+  post '/v3.3/extractions' do
     json_response(201, 'extraction.json')
   end
 
-  get '/v3.1/documents/:id' do
+  get '/v3.3/documents/:id' do
     json_response(200, 'document.json')
   end
 
-  get '/v3.1/documents' do
+  get '/v3.3/documents' do
     json_response(200, 'documents.json')
   end
 
-  get '/v3.1/documents/:id/download' do
+  get '/v3.3/documents/:id/download' do
     status 200
     content_type 'application/octet-stream'
     "\x01\x02\x03" # acts as binary file data
   end
 
-  post '/v3.1/live_photos' do
+  post '/v3.3/live_photos' do
     json_response(201, 'live_photo.json')
   end
 
-  get '/v3.1/live_photos/:id' do
+  get '/v3.3/live_photos/:id' do
     json_response(200, 'live_photo.json')
   end
 
-  get '/v3.1/live_photos' do
+  get '/v3.3/live_photos' do
     if params['applicant_id'] == '1030303-123123-123123'
       json_response(200, 'live_photos.json')
     else
@@ -80,17 +90,17 @@ class FakeOnfidoAPI < Sinatra::Base # rubocop:disable Metrics/ClassLength
     end
   end
 
-  get '/v3.1/live_photos/:id/download' do
+  get '/v3.3/live_photos/:id/download' do
     status 200
     content_type 'image/jpeg'
     "\x01\x02\x03" # acts as binary file data
   end
 
-  get '/v3.1/live_videos/:id' do
+  get '/v3.3/live_videos/:id' do
     json_response(200, 'live_video.json')
   end
 
-  get '/v3.1/live_videos' do
+  get '/v3.3/live_videos' do
     if params['applicant_id'] == '1030303-123123-123123'
       json_response(200, 'live_videos.json')
     else
@@ -98,80 +108,79 @@ class FakeOnfidoAPI < Sinatra::Base # rubocop:disable Metrics/ClassLength
     end
   end
 
-  get '/v3.1/live_videos/:id/download' do
+  get '/v3.3/live_videos/:id/download' do
     status 200
     content_type 'video/quicktime'
     "\x01\x02\x03" # acts as binary file data
   end
 
-  post '/v3.1/checks' do
+  post '/v3.3/checks' do
     params['applicant_id'].nil? ? status(422) : json_response(201, 'check.json')
   end
 
-  get '/v3.1/checks/:id' do
+  get '/v3.3/checks/:id' do
     json_response(200, 'check.json')
   end
 
-  get '/v3.1/checks' do
+  get '/v3.3/checks' do
     json_response(200, 'checks.json')
   end
 
-  post '/v3.1/checks/:id/resume' do
+  post '/v3.3/checks/:id/resume' do
     status 204 # no_content
   end
 
-  get '/v3.1/checks/:id/download' do
+  get '/v3.3/checks/:id/download' do
     status 200
     content_type 'application/pdf'
     "\x01\x02\x03" # acts as binary file data
   end
 
-  get '/v3.1/reports' do
+  get '/v3.3/reports' do
     json_response(200, 'reports.json')
   end
 
-  get '/v3.1/reports/:id' do
+  get '/v3.3/reports/:id' do
     json_response(200, 'report.json')
   end
 
-  post '/v3.1/reports/:id/resume' do
+  post '/v3.3/reports/:id/resume' do
     status 204
   end
 
-  post '/v3.1/reports/:id/cancel' do
+  post '/v3.3/reports/:id/cancel' do
     status 204
   end
 
-  post '/v3.1/sdk_token' do
+  post '/v3.3/sdk_token' do
     json_response(201, 'sdk_token.json')
   end
 
-  post '/v3.1/webhooks' do
+  post '/v3.3/webhooks' do
     json_response(201, 'webhook.json')
   end
 
-  get '/v3.1/webhooks/:id' do
+  get '/v3.3/webhooks/:id' do
     json_response(200, 'webhook.json')
   end
 
-  delete '/v3.1/webhooks/:id' do
-    content_type 'application/json; charset=utf-8'
+  delete '/v3.3/webhooks/:id' do
     status 204
   end
 
-  get '/v3.1/webhooks' do
+  get '/v3.3/webhooks' do
     json_response(200, 'webhooks.json')
   end
 
-  get '/v3.1/4xx_response' do
+  get '/v3.3/4xx_response' do
     json_response(422, '4xx_response.json')
   end
 
-  get '/v3.1/unexpected_error_format' do
+  get '/v3.3/unexpected_error_format' do
     json_response(400, 'unexpected_error_format.json')
   end
 
-  get '/v3.1/unparseable_response' do
+  get '/v3.3/unparseable_response' do
     content_type :json
     status 504
     ''

data/spec/support/fixtures/applicant.json

@@ -7,7 +7,7 @@
   "last_name":"Bing",
   "email":"chandler_bing_6@friends.com",
   "dob":"1968-04-08",
-  "href":"/v3.1/applicants/61f659cb-c90b-4067-808a-6136b5c01351",
+  "href":"/v3.3/applicants/61f659cb-c90b-4067-808a-6136b5c01351",
   "id_numbers":[],
   "address": {
     "flat_number":"4",

data/spec/support/fixtures/check.json

@@ -1,7 +1,7 @@
 {
   "id": "8546921-123123-123123",
   "created_at": "2019-05-23T13:50:33Z",
-  "href": "/v3.1/checks/8546921-123123-123123",
+  "href": "/v3.3/checks/8546921-123123-123123",
   "applicant_provides_data": "false",
   "status": "pending",
   "result": "pending",

data/spec/support/fixtures/checks.json

@@ -3,7 +3,7 @@
         {
             "id": "8546921-123123-123123",
             "created_at": "2019-11-23T13:50:33Z",
-            "href": "/v3.1/checks/8546921-123123-123123",
+            "href": "/v3.3/checks/8546921-123123-123123",
             "applicant_provides_data": "false",
             "status": "pending",
             "result": "pending",

data/spec/support/fixtures/document.json

@@ -1,7 +1,7 @@
 {
   "id": "7568415-123123-123123",
   "created_at": "2019-11-23 13:50:33Z",
-  "href": "/v3.1/documents/7568415-123123-123123",
+  "href": "/v3.3/documents/7568415-123123-123123",
   "file_name": "passport.jpg",
   "file_type": "png",
   "file_size": 282870,

data/spec/support/fixtures/documents.json

@@ -3,7 +3,7 @@
     {
       "id": "7568415-123123-123123",
       "created_at": "2019-11-23 13:50:33Z",
-      "href": "/v3.1/documents/7568415-123123-123123",
+      "href": "/v3.3/documents/7568415-123123-123123",
       "file_name": "passport.jpg",
       "file_type": "png",
       "file_size": 282870,
@@ -12,7 +12,7 @@
     {
       "id": "121122-123123-123123",
       "created_at": "2019-11-23 13:50:40Z",
-      "href": "/v3.1/documents/7568415-123123-123123",
+      "href": "/v3.3/documents/7568415-123123-123123",
       "file_name": "driving_licence.png",
       "file_type": "png",
       "file_size": 282870,

data/spec/support/fixtures/live_photo.json

@@ -4,6 +4,6 @@
   "file_name": "onfido_captured_image.jpg",
   "file_type": "image/jpeg",
   "file_size": 47544,
-  "href": "/v3.1/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1",
-  "download_href": "/v3.1/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1/download"
+  "href": "/v3.3/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1",
+  "download_href": "/v3.3/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1/download"
 }

data/spec/support/fixtures/live_photos.json

@@ -6,8 +6,8 @@
       "file_name": "onfido_captured_image.jpg",
       "file_type": "image/jpeg",
       "file_size": 47544,
-      "href": "/v3.1/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1",
-      "download_href": "/v3.1/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1/download"
+      "href": "/v3.3/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1",
+      "download_href": "/v3.3/live_photos/3538c8f6-fdce-4745-9d34-fc246bc05aa1/download"
     },
     {
         "id": "5134c12a-555a-1234-5e12-9d34fcbc11ba",
@@ -15,8 +15,8 @@
         "file_name": "onfido_captured_image.jpg",
         "file_type": "image/jpeg",
         "file_size": 47544,
-        "href": "/v3.1/live_photos/5134c12a-555a-1234-5e12-9d34fcbc11ba",
-        "download_href": "/v3.1/live_photos/5134c12a-555a-1234-5e12-9d34fcbc11ba/download"
+        "href": "/v3.3/live_photos/5134c12a-555a-1234-5e12-9d34fcbc11ba",
+        "download_href": "/v3.3/live_photos/5134c12a-555a-1234-5e12-9d34fcbc11ba/download"
       }
   ]
 }

data/spec/support/fixtures/live_video.json

@@ -18,6 +18,6 @@
   "file_name" : "output-29-05-2018_11_00_24.mov",
   "file_type" : "video/quicktime",
   "file_size" : 3348421,
-  "href" : "/v3.1/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01",
-  "download_href" : "/v3.1/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01/download"
+  "href" : "/v3.3/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01",
+  "download_href" : "/v3.3/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01/download"
 }

data/spec/support/fixtures/live_videos.json

@@ -16,11 +16,11 @@
         }
       ],
       "created_at": "2019-11-29T09:00:39Z",
-      "download_href": "/v3.1/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01/download",
+      "download_href": "/v3.3/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01/download",
       "file_name": "output-29-11-2019_11_00_24.mov",
       "file_size": 3348421,
       "file_type": "video/quicktime",
-      "href": "/v3.1/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01",
+      "href": "/v3.3/live_videos/c9701e9b-83aa-442f-995b-20320ee8fb01",
       "id": "c9701e9b-83aa-442f-995b-20320ee8fb01"
     }
   ]

data/spec/support/fixtures/report.json

@@ -4,7 +4,7 @@
   "created_at": "2019-11-23T13:50:45Z",
   "status": "in_progress",
   "result": "pending",
-  "href": "/v3.1/reports/6951786-123123-422221",
+  "href": "/v3.3/reports/6951786-123123-422221",
   "breakdown": {},
   "properties": {}
 }

data/spec/support/fixtures/reports.json

@@ -6,7 +6,7 @@
       "created_at": "2019-11-23T13:50:45Z",
       "status": "in_progress",
       "result": "pending",
-      "href": "/v3.1/reports/6951786-123123-422221",
+      "href": "/v3.3/reports/6951786-123123-422221",
       "breakdown": {},
       "properties": {}
     },
@@ -16,7 +16,7 @@
       "created_at": "2019-11-23T13:50:45Z",
       "status": "in_progress",
       "result": "pending",
-      "href": "/v3.1/reports/6951786-123123-316712",
+      "href": "/v3.3/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": "/v3.1/webhooks/fcb73186-0733-4f6f-9c57-d9d5ef979443",
+  "href": "/v3.3/webhooks/fcb73186-0733-4f6f-9c57-d9d5ef979443",
   "environments": [
     "live"
   ],

data/spec/support/fixtures/webhooks.json

@@ -4,7 +4,7 @@
       "id": "dd0a89e4-d44e-417a-aec4-01137d01ae59",
       "url": "https://demo.com",
       "enabled":false,
-      "href": "/v3.1/webhooks/dd0a89e4-d44e-417a-aec4-01137d01ae59",
+      "href": "/v3.3/webhooks/dd0a89e4-d44e-417a-aec4-01137d01ae59",
       "environments": [
         "live"
       ],
@@ -18,7 +18,7 @@
       "id": "bfc727a8-f7bf-4073-b123-ed70a70f58e5",
       "url": "https://demo2.com",
       "enabled": true,
-      "href": "/v3.1/webhooks/bfc727a8-f7bf-4073-b123-ed70a70f58e5",
+      "href": "/v3.3/webhooks/bfc727a8-f7bf-4073-b123-ed70a70f58e5",
       "environments": [
         "live"
       ],

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: onfido
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.2.0
 platform: ruby
 authors:
 - Onfido
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-10 00:00:00.000000000 Z
+date: 2022-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -122,7 +122,6 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE

data/.travis.yml

@@ -1,13 +0,0 @@
-language: ruby
-cache: bundler
-
-rvm:
-  - 2.4
-  - 2.5
-  - 2.6
-  - 2.7
-  - 3.0
-
-script:
-  - bundle exec rubocop
-  - bundle exec rspec spec