ninjaone 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b308dc5c61be46c792940ed58dc52596fa4146a1573e49db047396b1f959df61
-  data.tar.gz: 5cf673637b6af95d97ce82d81fd42970e47608aba6f018412b1d9c219f069c6a
+  metadata.gz: 69cf374dfc56664fdbbc61533fcffbc84cc8f378cc422641be286b5740d04d8f
+  data.tar.gz: e4f573f19bb88b7173a035622e65a86119ca20276806fa4df2ce40d2752adc29
 SHA512:
-  metadata.gz: 07a6c00f22eaaebcf0053a140641f642c93d89cdf898626c08dd72f364a87e55a16266d690571be0a4252e3502265d94619a79c34f7da692b584cce6edb7e410
-  data.tar.gz: d0a45f7032e93a8581e8a49976fdc7e7e2928cf18f657dd707fedadef5352e0ca84dd48b21ed25d434d9737c3c7597d4acca35bcfb775ffd5782759b0b916b3a
+  metadata.gz: '0090ba275e371d7064dee5ca2f432eb239ef6d31aa0aba63849c740834cc0c2cb6456d4d7f588a99475cb9ffa1add1c1349973b61c6c34e5ae3a90ae95b2966f'
+  data.tar.gz: 7d07158ecb6ab23ea23587453dfdadaf35df8906c8f5fbefa0c51e220782a866955338ca4dd849e9b49142dfd6c0f428859f60fe8ead3b401c072354489d97e2

data/CHANGELOG.md

@@ -4,3 +4,11 @@
 
 - Initial release
 
+## [0.2.0] - 2026-1-15
+
+- Added backup and devices api group
+
+## [0.2.1] - 2026-1-16
+
+- Simplify api endpoint definition
+

data/README.md

@@ -66,7 +66,7 @@ client.login
 
 |Resource|API endpoint|
 |:--|:--|
-|.auth_token or .login|https://app.ninjarmm.com/apidocs/?links.active=authorization|
+|`login`|https://app.ninjarmm.com/apidocs/?links.active=authorization|
 
 ### System
 
@@ -78,29 +78,29 @@ subscriptions = client.subscriptions
 
 |Resource|API endpoint|
 |:--|:--|
-|contacts, contact(id)|List contact and get contact details|
-|organizations|list organizations|
-|policies|list policies|
-|jobs|list active jobs|
-|activities|list activities|
-|alerts|List active alerts (triggered conditions)|
-|automation_scripts|List available automation scripts|
-|device_custom_fields|List device custom fields|
-|devices|List devices|
-|devices_detailed|List devices(deatiled)|
-|enabled_notification_channels|List enabled notification channels|
-|notification_channels|List all notification channels|
-|notification_channels_detailed|List all notification channels detailed|
-|groups|List all groups (saved searches)|
-|locations|List all locations|
-|roles|List device roles|
-|tasks|List scheduled tasks|
-|software_products|List supported 3rd party software|
-|users|List users|
-|search_devices(query_string)|Find devices|
-|user_end_users|End user list|
-|user_technicians|Technicians list|
-|user_roles|Get user roles|
+|`contacts`, `contact(id)`|List contact and get contact details|
+|`organizations`|list organizations|
+|`policies`|list policies|
+|`jobs`|list active jobs|
+|`activities`|list activities|
+|`alerts`|List active alerts (triggered conditions)|
+|`automation_scripts`|List available automation scripts|
+|`device_custom_fields`|List device custom fields|
+|`devices`|List devices|
+|`devices_detailed`|List devices(deatiled)|
+|`notification_channels_enabled`|List enabled notification channels|
+|`notification_channels`|List all notification channels|
+|`notification_channels_detailed`|List all notification channels detailed|
+|`groups`|List all groups (saved searches)|
+|`locations`|List all locations|
+|`roles`|List device roles|
+|`tasks`|List scheduled tasks|
+|`software_products`|List supported 3rd party software|
+|`users`|List users|
+|`search_devices(query_string)`|Find devices|
+|`user_end_users`|End user list|
+|`user_technicians`|Technicians list|
+|`user_roles`|Get user roles|
 
 ### Organizations
 
@@ -114,13 +114,51 @@ org_devices = client.organization_devices(org.id)
 
 |Resource|API endpoint|
 |:--|:--|
-|.organizations,.organization(id)|List organizations or get one by id|
-|.organization_locations(id)|Organization locations|
-|.organization_end_users(id)|List users|
-|.organization_custom_fields(id)|Organization custom fields|
-|.organization_devices(id)|Organization devices|
-|.organization_locations_backup_usage(id)|Organization location backup usage|
-|.organization_backup_usage_by_location(id, location_id)|Organization locations backup usage|
+|`organizations`,`organization(id)`|List organizations or get one by id|
+|`organization_locations(id)`|Organization locations|
+|`organization_end_users(id)`|List users|
+|`organization_custom_fields(id)`|Organization custom fields|
+|`organization_devices(id)`|Organization devices|
+|`organization_locations_backup_usage(id)`|Organization location backup usage|
+|`organization_backup_usage_by_location(id, location_id)`|Organization locations backup usage|
+
+### Backup
+
+All apis related to backup
+
+```ruby
+# get failed jobs using status filter
+failed_jobs = client.backup_jobs(sf:'status = FAILED')
+```
+
+|Resource|API endpoint|
+|:--|:--|
+|`backup_jobs(params)`|Returns list of backup jobs. Params is a hash for filtering the result|
+|`backup_integrity_check_jobs(params)`|Returns a list of integrity check jobs|
+
+### Devices
+
+All apis related to devices.
+
+| Resource | API endpoint |
+|:--|:--|
+| `device(id, params = {})` | Retrieves the details of a single device by its device ID. |
+| `device_jobs(id, params = {})` | Retrieves all jobs associated with the specified device. |
+| `device_activities(id, params = {})` | Retrieves activities for the specified device (e.g. filtered using `since`). |
+| `device_alerts(id, params = {})` | Retrieves alerts related to the specified device. |
+| `device_disks(id, params = {})` | Retrieves disk information for the specified device. |
+| `device_processors(id, params = {})` | Retrieves processor information for the specified device. |
+| `device_software(id, params = {})` | Retrieves installed software for the specified device. |
+| `device_volumes(id, params = {})` | Retrieves volume information for the specified device. |
+| `device_windows_services(id, params = {})` | Retrieves Windows services for the specified device. |
+| `device_custom_fields(id, params = {})` | Retrieves custom fields associated with the specified device. |
+| `device_os_patch_installs(id, params = {})` | Retrieves operating system patch installation records for the specified device. |
+| `device_software_patch_installs(id, params = {})` | Retrieves software patch installation records for the specified device. |
+| `device_last_logged_on_user(id, params = {})` | Retrieves information about the last logged-on user of the device. |
+| `device_network_interfaces(id, params = {})` | Retrieves network interface information for the specified device. |
+| `device_os_patches(id, params = {})` | Retrieves available or installed operating system patches for the device. |
+| `device_software_patches(id, params = {})` | Retrieves available or installed software patches for the device. |
+| `device_policy_overrides(id, params = {})` | Retrieves policy overrides applied to the specified device. |
 
 
 ## Contributing

data/lib/ninjaone/client/backup.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module NinjaOne
+  class Client
+    # Contains Backup-related API calls for Ninja One.
+    #
+    # @see https://app.ninjarmm.com/apidocs/?links.active=core#/Backup Ninja One Developer Documentation - Backup section
+    module Backup
+
+      # Backup endpoints (GET)
+      Client::define_endpoint('backup/jobs')
+      Client::define_endpoint('backup/integrity-check-jobs')
+    end
+  end
+end

data/lib/ninjaone/client/devices.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module NinjaOne
+  class Client
+    # Contains Device-related API calls for Ninja One.
+    #
+    # @see https://app.ninjarmm.com/apidocs/?links.active=core#/Devices Ninja One Developer Documentation - Device section
+    module Devices
+
+      Client::define_endpoint(:device, '')
+
+      # Device-related GET endpoints.
+      #
+      # Each symbol below dynamically generates a method:
+      #   device_<endpoint>(id, params = {})
+      #
+      # Example:
+      #   device_jobs(123)
+      #   device_activities(123, since: '2026-01-01T00:00:00Z')
+      #
+      [:jobs, :activities, :alerts, :disks, :processors, :software, :volumes, :windows_services, :custom_fields,
+       :os_patch_installs, :software_patch_installs, :last_logged_on_user, :network_interfaces, :os_patches, :software_patches].each do |resource|
+        Client::define_endpoint(:device, resource.to_s.gsub('_','-'))
+      end
+      Client::define_endpoint(:device, 'policy/overrides')
+    end
+  end
+end

data/lib/ninjaone/client/organizations.rb

@@ -6,41 +6,18 @@ module NinjaOne
     #
     # @see https://app.ninjarmm.com/apidocs/?links.active=core#/organization Ninja One Developer Documentation
     module Organizations
-      # Dynamically defines methods for interacting with NinjaOne API resources.
-      #
-      # Depending on the arguments, this will define methods to:
-      # - Fetch all records for a resource
-      # - Fetch a specific record by ID
-      #
-      # @param method [Symbol] The method name for fetching all records.
-      # @param singular_method [Symbol, nil] The method name for fetching a single record by ID. Optional.
-      # @param path [String] The API path for the resource. Defaults to the method name.
-      #
-      # @example Defining endpoints
-      #   api_endpoint :companies, :company
-      #   # Defines:
-      #   # - `companies(params = {})` to fetch all companies.
-      #   # - `company(id, params = {})` to fetch a single company by ID.
-      def self.api_endpoint_suffix(method, suffix)
-        # Define method to fetch a single record by ID
-        name = "#{method}_#{suffix.gsub(/[-\/]/,'_')}"
 
-        send(:define_method, name) do |id, params = {}|
-          get(api_url("#{method}/#{id}/#{suffix}"), params)
-        end
-      end
-
-      api_endpoint_suffix(:organization, 'locations')
-      api_endpoint_suffix(:organization, 'end-users')
-      api_endpoint_suffix(:organization, 'custom-fields')
-      api_endpoint_suffix(:organization, 'devices')
-      api_endpoint_suffix(:organization, 'locations/backup/usage')
+      Client::define_endpoint(:organization, 'locations')
+      Client::define_endpoint(:organization, 'end-users')
+      Client::define_endpoint(:organization, 'custom-fields')
+      Client::define_endpoint(:organization, 'devices')
+      Client::define_endpoint(:organization, 'locations/backup/usage')
 
       # Returns a location backup usage
       def organization_backup_usage_by_location(id, location_id, params={})
         get(api_url("organization/#{id}/locations/#{location_id}/backup/usage"), params)
       rescue Faraday::ServerError
-        # it looks like a server error is thrown when no backup is available; fake it by returning anempty array
+        # it looks like a server error is thrown when no backup is available; fake it by returning an empty array
         []
       end
     end

data/lib/ninjaone/client/system.rb

@@ -7,28 +7,30 @@ module NinjaOne
     # @see https://app.ninjarmm.com/apidocs/?links.active=core#/system Ninja One Developer Documentation
     module System
 
-      Client::api_endpoint(:contacts, :contact)
-      Client::api_endpoint(:organizations,:organization)
-      Client::api_endpoint(:organizations_detailed)
-      Client::api_endpoint(:policies)
-      Client::api_endpoint(:jobs)
-      Client::api_endpoint(:activities)
-      Client::api_endpoint(:alerts)
-      Client::api_endpoint(:automation_scripts, nil, 'automation/scripts')
-      Client::api_endpoint(:devices)
-      Client::api_endpoint(:devices_detailed)
-      Client::api_endpoint(:enabled_notification_channels, nil, 'notification-channels/enabled')
-      Client::api_endpoint(:notification_channels)
-      Client::api_endpoint(:groups)
-      Client::api_endpoint(:locations)
-      Client::api_endpoint(:roles)
-      Client::api_endpoint(:tasks)
-      Client::api_endpoint(:software_products)
-      Client::api_endpoint(:users)
-      Client::api_endpoint(:user_end_users, nil, 'user/end-users')
-      Client::api_endpoint(:user_roles, nil, 'user/roles')
-      Client::api_endpoint(:user_technicians, nil, 'user/technicians')
-      Client::api_endpoint(:devices_search, nil, 'devices/search')
+      Client::define_endpoint(:contacts)
+      Client::define_endpoint(:contact, '')
+      Client::define_endpoint(:organizations)
+      Client::define_endpoint(:organization, '')
+      Client::define_endpoint('organizations-detailed')
+      Client::define_endpoint(:policies)
+      Client::define_endpoint(:jobs)
+      Client::define_endpoint(:activities)
+      Client::define_endpoint(:alerts)
+      Client::define_endpoint('automation/scripts')
+      Client::define_endpoint(:devices)
+      Client::define_endpoint('devices-detailed')
+      Client::define_endpoint('notification-channels/enabled')
+      Client::define_endpoint('notification-channels')
+      Client::define_endpoint(:groups)
+      Client::define_endpoint(:locations)
+      Client::define_endpoint(:roles)
+      Client::define_endpoint(:tasks)
+      Client::define_endpoint('software-products')
+      Client::define_endpoint(:users)
+      Client::define_endpoint('user/end-users')
+      Client::define_endpoint('user/roles')
+      Client::define_endpoint('user/technicians')
+      Client::define_endpoint('devices/search')
       
       def search_devices(query_string, options={})
         devices_search(options.merge({q:query_string}))

data/lib/ninjaone/client.rb

@@ -9,34 +9,50 @@ module NinjaOne
   # @note All methods are grouped in separate modules for better organization and follow the structure provided in the official API documentation.
   # @see https://developers.skykick.com/Guides/Authentication
   class Client < API
+
+    # Constructs url resource name from url path
+    #
+    # @param path [String] Resource name
+    # @return [String] translated from /- to  _
+    def self.resource_to_name(path)
+      path.to_s.gsub(/[-\/]/,'_')
+    end
+
     # Dynamically defines methods for interacting with NinjaOne API resources.
     #
     # Depending on the arguments, this will define methods to:
-    # - Fetch all records for a resource
-    # - Fetch a specific record by ID
+    # - Fetch all records for the given scope
+    # - Fetch a resource specific record by ID
+    #
+    # @param scope [Symbol] The method name for fetching all records.
+    # @param resource [String] If given, fetches all records for scope by id. If empty string, it will load single scope record
     #
-    # @param method [Symbol] The method name for fetching all records.
-    # @param singular_method [Symbol, nil] The method name for fetching a single record by ID. Optional.
-    # @param path [String] The API path for the resource. Defaults to the method name.
+    # Paging is not supported.
     #
     # @example Defining endpoints
     #   api_endpoint :companies, :company
     #   # Defines:
     #   # - `companies(params = {})` to fetch all companies.
     #   # - `company(id, params = {})` to fetch a single company by ID.
-    def self.api_endpoint(method, singular_method = nil, path = method.to_s.tr('_', '-'))
-      # Define method to fetch all records
-      send(:define_method, method) do |params = {}|
-        get_paged(api_url(path), params)
-      end
-      # Define method to fetch a single record by ID
-      if singular_method
-        send(:define_method, singular_method) do |id, params = {}|
-          get(api_url("#{singular_method}/#{id}"), params)
+    def self.define_endpoint(scope, resource = nil)
+      if resource
+        name = self.resource_to_name(scope)
+        name = "#{name}_#{self.resource_to_name(resource)}" if resource && !resource.empty?
+        # change to nil if resource is empty so we ar eable to generate /scope/id/resource
+        # but also /scope/id without training / 
+        resource = resource&.empty? ? nil : resource
+        send(:define_method, name) do |id, params = {}|
+          get(api_url([scope, id, resource].compact.join('/')), params)
+        end
+      else
+        name = self.resource_to_name(scope)
+        send(:define_method, name) do |params = {}|
+          get(api_url(scope), params)
         end
       end
     end
 
+
     # Dynamically require all files in the `client` directory.
     # This will load additional API modules as separate files for better modularity and code organization.
     Dir[File.expand_path('client/*.rb', __dir__)].each { |f| require f }
@@ -46,6 +62,8 @@ module NinjaOne
     # such as managing backups and handling alerts.
     include NinjaOne::Client::System
     include NinjaOne::Client::Organizations
+    include NinjaOne::Client::Backup
+    include NinjaOne::Client::Devices
 
     # Constructs the full API URL for a given path.
     #
@@ -54,6 +72,5 @@ module NinjaOne
     def api_url(path)
       "/v2/#{path}"
     end
-
   end
 end

data/lib/ninjaone/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NinjaOne
-  VERSION = '0.1.0'
+  VERSION = '0.2.1'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ninjaone
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Janco Tanis
 bindir: exe
 cert_chain: []
-date: 2025-12-10 00:00:00.000000000 Z
+date: 2026-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -108,6 +108,8 @@ files:
 - lib/ninjaone/api.rb
 - lib/ninjaone/authentication.rb
 - lib/ninjaone/client.rb
+- lib/ninjaone/client/backup.rb
+- lib/ninjaone/client/devices.rb
 - lib/ninjaone/client/organizations.rb
 - lib/ninjaone/client/system.rb
 - lib/ninjaone/error.rb