reso_api 1.5.12 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe6b62537e98721783095b15ca0a1558afa19b2c8ccd946ec91c983b55c9fa3d
-  data.tar.gz: 0c4e9c6604c438e2f1d6ae904bd1548b88ade1c6779be45f909ff4a007b4b290
+  metadata.gz: ec848b7c652396095ce3180d40c57015bdd40a20f54898500cf560ed66b0f4dd
+  data.tar.gz: a2a40ca2833627b66fa7b2d64381ec57ab96ac0b846ff3a9290299dd4574aa3d
 SHA512:
-  metadata.gz: b5859b59e1028ea2a36b9e606c7ed851163740426948179765ecdae8cfbebb19952913ed5123bdfd3b8aa671bbf01402bbd15cc194f44ab6ac7d89fb25bc0fd0
-  data.tar.gz: 7367048493db7e3eec61c740bafa36c81990c7d6d3111a617cd374d2d660deeb45e61c49f578deb8a1c1b4a82cb0ff15729013e548bcd113916020e70db30c97
+  metadata.gz: 21caa86ce758a79a23b4b8729a887a698aff3f236f310ced36b2f1cfadc8184cf605021ed31ff97a4d7731d36a0f5aaaf2be1ae63e9ff049c36b63d66794b8bd
+  data.tar.gz: 0f6f792e96a0690a2e7a66fd94175c373df2f1a9e64e00f0e98087aa3a95e21c2f50bb218a28415de1bab00447c2d7992c9d9718233e4265645826deff214791

data/README.md

@@ -26,14 +26,21 @@ Or install it yourself as:
 
 ### Authentication and Access
 
-To set up an API client and access a service, you need three pieces of information:
+This gem supports two types of authentication:
+
+- OAuth2
+- Access Token
+
+#### OAuth2
+
+To set up an API client using OAuth2 authentication, you need four pieces of information:
 
 - Client ID
 - Client Secret
 - Base API endpoint
 - Authentication URL
 
-You'll recognize the base API endpoint by it ending with /odata, and the authentication URL by it likely ending with /token.
+Often, the base API endpoint ends with `/odata`, and the authentication URL often ends with `/token`.
 
 You pass these four pieces of information to create an instance of an API client:
 
@@ -43,6 +50,20 @@ client = RESO::API::Client.new(client_id: client_id, client_secret: client_secre
 
 When calling API endpoints using the initialized client, it will automatically fetch and manage access and authentication tokens transparently in the background.
 
+#### Access Token
+
+Some systems, like MLSGRID and Spark/Flexmls provides a persistent Access Token. In these cases, you need these two pieces of information to set up an API client:
+
+- Access Token
+- Base API endpoint
+
+You pass these two pieces of information to create an instance of an API client:
+
+```ruby
+client = RESO::API::Client.new(access_token: access_token, base_url: base_url)
+```
+
+
 ### Resources
 
 #### Supported Resources

data/lib/reso_api/app/models/reso/api/client.rb

@@ -7,18 +7,22 @@ module RESO
       require 'json'
       require 'tmpdir'
 
-      attr_accessor :client_id, :client_secret, :auth_url, :base_url
+      attr_accessor :access_token, :client_id, :client_secret, :auth_url, :base_url
 
       def initialize(**opts)
-        @client_id, @client_secret, @auth_url, @base_url = opts.values_at(:client_id, :client_secret, :auth_url, :base_url)
+        @access_token, @client_id, @client_secret, @auth_url, @base_url = opts.values_at(:access_token, :client_id, :client_secret, :auth_url, :base_url)
         validate!
       end
 
       def validate!
-        raise 'Missing Client ID `client_id`' if client_id.nil?
-        raise 'Missing Client Secret `client_secret`' if client_secret.nil?
-        raise 'Missing Authentication URL `auth_url`' if auth_url.nil?
-        raise 'Missing API Base URL `base_url`' if base_url.nil?
+        if access_token.nil?
+          raise 'Missing Client ID `client_id`' if client_id.nil?
+          raise 'Missing Client Secret `client_secret`' if client_secret.nil?
+          raise 'Missing Authentication URL `auth_url`' if auth_url.nil?
+          raise 'Missing API Base URL `base_url`' if base_url.nil?
+        else
+          raise 'Missing API Base URL `base_url`' if base_url.nil?
+        end
       end
 
       RESOURCE_KEYS = {
@@ -96,6 +100,10 @@ module RESO
         end
       end
 
+      def auth_token
+        access_token.presence ? access_token : oauth2_token
+      end
+
       def oauth2_client
         OAuth2::Client.new(
           client_id,
@@ -126,7 +134,7 @@ module RESO
       end
 
       def oauth2_token_path
-        File.join(Dir.tmpdir, [base_url.parameterize, "-oauth-token.json"].join)
+        File.join(Dir.tmpdir, [base_url.parameterize, client_id, "oauth-token.json"].join("-"))
       end
 
       def oauth2_payload
@@ -158,7 +166,7 @@ module RESO
         end
         begin
           req = Net::HTTP::Get.new(uri.request_uri)
-          req['Authorization'] = "Bearer #{oauth2_token}"
+          req['Authorization'] = "Bearer #{auth_token}"
           res = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
             http.request(req)
           end

data/lib/reso_api/version.rb

@@ -1,3 +1,3 @@
 module ResoApi
-  VERSION = "1.5.12"
+  VERSION = "1.6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reso_api
 version: !ruby/object:Gem::Version
-  version: 1.5.12
+  version: 1.6.0
 platform: ruby
 authors:
 - Michael Edlund
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -123,7 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.4.21
 signing_key:
 specification_version: 4
 summary: RESO Web API Wrapper