nordigen_ob_client 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 720c32a7fae42823603e24b6e1afc0122e798620d18ac41bc4685d9a5b9e024c
-  data.tar.gz: 3e0b7ccbe0363566cada63f5e80e2d3d2895e8c7f4229117127bf4a7d7107a05
+  metadata.gz: 31402b13055928acda8e67cb92102f5c7537905bd3003efc7ca33519e0b1ff83
+  data.tar.gz: 3f8468216d6cb6947ae0f6730a380e41de7717b007cb64dc8706321e9dd87222
 SHA512:
-  metadata.gz: becd5aec428708e1a522b4795080d6d011dc082e062c75ea2bc4916b63f732785acfae857e75fc8fb64144e2ab0a909cc636b54cf967819a36b130f1f6758e04
-  data.tar.gz: 5dfb8555ba43701eb67187ff263df392995e51375da96d7a6e01a4f2af688cec195efcb3f524cd203cc4e1dd7c281c9ba91dae00d10aa5141fbfe1632599ce86
+  metadata.gz: 8e2c1c19962e6a4d911106ff67b57db74b01ee7852a6934e7d33181c2602d31aad7072d016fe0beedbdd5e364e2acfa0d6ef424317f8f1ee4bb493dc3d4f46d9
+  data.tar.gz: 8b9e0564a28ac0be990f2823439ecd5c96a8cd32b71f74bed545ae90ff67f03074a41a6e3c82fff09759132e3ea912ec939bc95e39b32710fefa7b0f2a366d7c

data/lib/nordigen_ob_client.rb

@@ -1,5 +1,4 @@
 require 'json'
-require 'net/http'
 require 'rest-client'
 
 class NordigenOBClient
@@ -34,6 +33,13 @@ class NordigenOBClient
                                     {content_type: :json, accept: :json})
     response = JSON.parse(response_json.body)
     @access_token = response["access"]
+
+    @request_header = {
+      content_type: :json,
+      accept: :json,
+      authorization: "Bearer #{@access_token}"
+    }
+
     @access_token
   end
 
@@ -52,15 +58,9 @@ class NordigenOBClient
   #
   #############################################################################
   def get_banks_by_country country
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/institutions/?country=#{country}",
-      headers=request_header)
+      headers=@request_header)
 
     available_banks = JSON.parse(response.body,
                                 :external_encoding => 'iso-8859-1')
@@ -83,80 +83,144 @@ class NordigenOBClient
   #
   #############################################################################
   def list_accounts requisition_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/requisitions/#{requisition_id}",
-      headers=request_header)
+      headers=@request_header)
     accounts = JSON.parse(response.body)
     accounts
   end
 
+  #############################################################################
+  #
+  # => Name: get_account_details
+  #
+  # => Description: Return's all the information available for the account.
+  #
+  # => Parameters: account_id: The id of the account (IBAN)
+  #                for which the information will be returned.
+  #
+  #
+  # => Returns: The details available for the account. They can vary from bank
+  #             to bank. The fields we see been returned always are:
+  #               - IBAN
+  #               - Currency
+  #               - Owner Name
+  #               - Product / account type (e.g. Savings, holding, etc.)
+  #               - BIC
+  #               - Usage: Private / Bureau
+  #
+  #############################################################################
   def get_account_details account_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/accounts/#{account_id}/details",
-      headers=request_header)
+      headers=@request_header)
     accounts = JSON.parse(response.body)
     accounts
   end
 
 
+  #############################################################################
+  #
+  # => Name: get_account_balances
+  #
+  # => Description: Return's the balances for the given account. The balances
+  #                 can be more than one, since accounts allow overdraft or
+  #                 might have frozen limits.
+  #
+  # => Parameters: account_id: The id of the account (IBAN)
+  #                for which the balances will be returned.
+  #
+  #
+  # => Returns: The details available for the account. They can vary from bank
+  #             to bank. The fields we see been returned always are:
+  #               - Balance amount
+  #               - Currency
+  #               - Type of balances
+  #               - Balance date
+  #
+  #############################################################################
   def get_account_balances account_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/accounts/#{account_id}/balances",
-      headers=request_header)
+      headers=@request_header)
     accounts = JSON.parse(response.body)
     accounts
   end
 
 
+  #############################################################################
+  #
+  # => Name: get_account_overview
+  #
+  # => Description: Return's the basic information available for the account.
+  #
+  # => Parameters: account_id: The id of the account (IBAN)
+  #                for which the information will be returned.
+  #
+  #
+  # => Returns: A summaru available for the account. THe fields included are:
+  #               - IBAN
+  #               - Nordigen's institution ID
+  #               - Status: ready, inactive
+  #               - Owner's name
+  #
+  #############################################################################
   def get_account_overview account_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/accounts/#{account_id}",
-      headers=request_header)
+      headers=@request_header)
     accounts = JSON.parse(response.body)
     accounts
   end
 
 
+  #############################################################################
+  #
+  # => Name: get_account_transactions
+  #
+  # => Description: Return's the account statement for the last 90 days.
+  #
+  # => Parameters: account_id: The id of the account (IBAN)
+  #                for which the information will be returned.
+  #
+  #
+  # => Returns: The list of transactions performed. THe fields included are:
+  #               - Booking date, when the transaction was logged on the account.
+  #               - Reference date, when it actually occured.
+  #               - Transaction amount
+  #               - Currency
+  #               - Debitor BIC
+  #               - Creditor BIC
+  #
+  #############################################################################
   def get_account_transactions account_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.get(
       "https://ob.nordigen.com/api/v2/accounts/#{account_id}/transactions",
-      headers=request_header)
+      headers=@request_header)
     accounts = JSON.parse(response.body)
     accounts
   end
 
 
-
+  #############################################################################
+  #
+  # => Name: create_requisition
+  #
+  # => Description: It creates a new requisition ID that will enable the user
+  #                 to connect his bank accounts.
+  #
+  # => Parameters: redirect_url: The URL to which the user will be redirected
+  #                after logging in to his bank environment.
+  #
+  #                selected_bank_id: The Nordigen ID of the bank the user
+  #                will be redirected.
+  #
+  #                reference: A unique user identifier that will associate
+  #                the user who will log in with the new requisition ID.
+  #
+  # => Returns: The access token
+  #
+  #############################################################################
   def create_requisition redirect_url, selected_bank_id, reference
     request_body = {
                     "redirect" => redirect_url,
@@ -165,31 +229,29 @@ class NordigenOBClient
                     "reference" => reference
     }.to_json
 
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.post(
       "https://ob.nordigen.com/api/v2/requisitions/",
       request_body,
-      headers=request_header)
+      headers=@request_header)
     JSON.parse(response.body)
   end
 
 
+  #############################################################################
+  #
+  # => Name: delete_requisition
+  #
+  # => Description: It deletes the provided requisition ID.
+  #
+  # => Parameters: requisition_id: The requisition to delete.
+  #
+  # => Returns: The result of the operation
+  #
+  #############################################################################
   def delete_requisition requisition_id
-    request_header = {
-      content_type: :json,
-      accept: :json,
-      authorization: "Bearer #{@access_token}"
-    }
-
     response = RestClient.delete(
       "https://ob.nordigen.com/api/v2/requisitions/#{requisition_id}",
-      request_body,
-      headers=request_header)
+      headers=@request_header)
     JSON.parse(response.body)
     response
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nordigen_ob_client
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Angelos Kapsimanis
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-31 00:00:00.000000000 Z
+date: 2022-12-16 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby client for Nordigen's Open Banking v2.0 API. Look at https://nordigen.com/en/account_information_documenation/api-documention/overview/
   for more details.