ngrok-api 0.9.0 → 0.12.0

data/lib/ngrokapi/services/api_keys_client.rb

@@ -1,144 +1,203 @@
-# frozen_string_literal: true
-
-module NgrokAPI
-  module Services
-    ##
-    # A client for interacting with the api_keys API
-    #
-    # https://ngrok.com/docs/api#api-api-keys
-    class ApiKeysClient
-      # The List Property from the resulting API for list calls
-      LIST_PROPERTY = 'keys'
-      # The API path for API keys
-      PATH = '/api_keys'
-
-      attr_reader :client
-
-      def initialize(client:)
-        @client = client
-      end
-
-      # rubocop:disable LineLength
-
-      ##
-      # Create a new API key. The generated API key can be used to authenticate to the ngrok API.
-      #
-      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
-      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
-      # @return [NgrokAPI::Models::ApiKey] result from create request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-create
-      def create(description: nil, metadata: nil)
-        result = @client.post(PATH, data: build_data(description: description, metadata: metadata))
-        NgrokAPI::Models::ApiKey.new(client: self, result: result)
-      end
-      # rubocop:enable LineLength
-
-      ##
-      # Delete an API key by ID.
-      #
-      # @param [string] id a resource identifier
-      # @return [nil] result from delete request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-delete
-      def delete(id: nil)
-        @client.delete("#{PATH}/#{id}")
-      end
-
-      ##
-      # Delete an API key by ID. Throw an exception if 404.
-      #
-      # @param [string] id a resource identifier
-      # @return [nil] result from delete request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-delete
-      def delete!(id: nil)
-        @client.delete("#{PATH}/#{id}", danger: true)
-      end
-
-      ##
-      # Get the details of an API key by ID.
-      #
-      # @param [string] id a resource identifier
-      # @return [NgrokAPI::Models::ApiKey] result from get request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-get
-      def get(id: nil)
-        result = @client.get("#{PATH}/#{id}")
-        NgrokAPI::Models::ApiKey.new(client: self, result: result)
-      end
-
-      ##
-      # Get the details of an API key by ID. Throw an exception if 404.
-      #
-      # @param [string] id a resource identifier
-      # @return [NgrokAPI::Models::ApiKey] result from get request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-get
-      def get!(id: nil)
-        result = @client.get("#{PATH}/#{id}", danger: true)
-        NgrokAPI::Models::ApiKey.new(client: self, result: result)
-      end
-
-      ##
-      # List all API keys owned by this account.
-      #
-      # @param [string] before_id
-      # @param [integer] limit
-      # @param [string] url optional and mutually exclusive from before_id and limit
-      # @return [NgrokAPI::Models::Listable] the result listable
-      #
-      # https://ngrok.com/docs/api#api-api-keys-list
-      def list(before_id: nil, limit: nil, url: nil)
-        result = @client.list(before_id: before_id, limit: limit, url: url, path: PATH)
-        NgrokAPI::Models::Listable.new(
-          client: self,
-          result: result,
-          list_property: LIST_PROPERTY,
-          klass: NgrokAPI::Models::ApiKey
-        )
-      end
-
-      # rubocop:disable LineLength
-
-      ##
-      # Update attributes of an API key by ID.
-      #
-      # @param [string] id
-      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
-      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
-      # @return [NgrokAPI::Models::ApiKey] result from update request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-update
-      def update(id: nil, description: nil, metadata: nil)
-        result = @client.patch("#{PATH}/#{id}", data: build_data(description: description, metadata: metadata))
-        NgrokAPI::Models::ApiKey.new(client: self, result: result)
-      end
-
-      ##
-      # Update attributes of an API key by ID.
-      #
-      # @param [string] id
-      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
-      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
-      # @return [NgrokAPI::Models::ApiKey] result from update request
-      #
-      # https://ngrok.com/docs/api#api-api-keys-update
-      def update!(id: nil, description: nil, metadata: nil)
-        data = build_data(description: description, metadata: metadata)
-        result = @client.patch("#{PATH}/#{id}", danger: true, data: data)
-        NgrokAPI::Models::ApiKey.new(client: self, result: result)
-      end
-      # rubocop:enable LineLength
-
-      private
-
-      def build_data(description: nil, metadata: nil)
-        data = {}
-        data[:description] = description if description
-        data[:metadata] = metadata if metadata
-        data
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # API Keys are used to authenticate to the
+    # (https://ngrok.com/docs/api#authentication)ngrok
+    #  API. You may use the API itself
+    #  to provision and manage API Keys but you'll need to provision your first API
+    #  key from the  (https://dashboard.ngrok.com/api/keys)API Keys page on your
+    #  ngrok.com dashboard.
+    #
+    # https://ngrok.com/docs/api#api-api-keys
+    class APIKeysClient
+      # The API path for the requests
+      PATH = '/api_keys'
+      # The List Property from the resulting API for list calls
+      LIST_PROPERTY = 'keys'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # Create a new API key. The generated API key can be used to authenticate to the
+      # ngrok API.
+      #
+      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
+      # @return [NgrokAPI::Models::APIKey] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-create
+      def create(
+        description: "",
+        metadata: ""
+      )
+        path = '/api_keys'
+        replacements = {
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        result = @client.post(path % replacements, data: data)
+        NgrokAPI::Models::APIKey.new(client: self, result: result)
+      end
+
+      ##
+      # Delete an API key by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-delete
+      def delete(
+        id: ""
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements)
+      end
+
+      ##
+      # Delete an API key by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-delete
+      def delete!(
+        id: ""
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements, danger: true)
+      end
+
+      ##
+      # Get the details of an API key by ID.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::APIKey] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-get
+      def get(
+        id: ""
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::APIKey.new(client: self, result: result)
+      end
+
+      ##
+      # Get the details of an API key by ID.
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::APIKey] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-get
+      def get!(
+        id: ""
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::APIKey.new(client: self, result: result)
+      end
+
+      ##
+      # List all API keys owned by this account
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-list
+      def list(
+        before_id: nil,
+        limit: nil,
+        url: nil
+      )
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          url: url,
+          path: PATH
+        )
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          result: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::APIKey
+        )
+      end
+
+      ##
+      # Update attributes of an API key by ID.
+      #
+      # @param [string] id
+      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
+      # @return [NgrokAPI::Models::APIKey] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-update
+      def update(
+        id: "",
+        description: nil,
+        metadata: nil
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        result = @client.patch(path % replacements, data: data)
+        NgrokAPI::Models::APIKey.new(client: self, result: result)
+      end
+
+      ##
+      # Update attributes of an API key by ID.
+      # Throws an exception if API error.
+      #
+      # @param [string] id
+      # @param [string] description human-readable description of what uses the API key to authenticate. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined data of this API key. optional, max 4096 bytes
+      # @return [NgrokAPI::Models::APIKey] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-api-keys-update
+      def update!(
+        id: "",
+        description: nil,
+        metadata: nil
+      )
+        path = '/api_keys/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        result = @client.patch(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::APIKey.new(client: self, result: result)
+      end
+    end
+  end
+end

data/lib/ngrokapi/services/certificate_authorities_client.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # Certificate Authorities are x509 certificates that are used to sign other
+    #  x509 certificates. Attach a Certificate Authority to the Mutual TLS module
+    #  to verify that the TLS certificate presented by a client has been signed by
+    #  this CA. Certificate Authorities  are used only for mTLS validation only and
+    #  thus a private key is not included in the resource.
+    #
+    # https://ngrok.com/docs/api#api-certificate-authorities
+    class CertificateAuthoritiesClient
+      # The API path for the requests
+      PATH = '/certificate_authorities'
+      # The List Property from the resulting API for list calls
+      LIST_PROPERTY = 'certificate_authorities'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # Upload a new Certificate Authority
+      #
+      # @param [string] description human-readable description of this Certificate Authority. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
+      # @param [string] ca_pem raw PEM of the Certificate Authority
+      # @return [NgrokAPI::Models::CertificateAuthority] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-create
+      def create(
+        description: "",
+        metadata: "",
+        ca_pem:
+      )
+        path = '/certificate_authorities'
+        replacements = {
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:ca_pem] = ca_pem if ca_pem
+        result = @client.post(path % replacements, data: data)
+        NgrokAPI::Models::CertificateAuthority.new(client: self, result: result)
+      end
+
+      ##
+      # Delete a Certificate Authority
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-delete
+      def delete(
+        id: ""
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements)
+      end
+
+      ##
+      # Delete a Certificate Authority
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-delete
+      def delete!(
+        id: ""
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements, danger: true)
+      end
+
+      ##
+      # Get detailed information about a certficate authority
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::CertificateAuthority] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-get
+      def get(
+        id: ""
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::CertificateAuthority.new(client: self, result: result)
+      end
+
+      ##
+      # Get detailed information about a certficate authority
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::CertificateAuthority] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-get
+      def get!(
+        id: ""
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::CertificateAuthority.new(client: self, result: result)
+      end
+
+      ##
+      # List all Certificate Authority on this account
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-list
+      def list(
+        before_id: nil,
+        limit: nil,
+        url: nil
+      )
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          url: url,
+          path: PATH
+        )
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          result: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::CertificateAuthority
+        )
+      end
+
+      ##
+      # Update attributes of a Certificate Authority by ID
+      #
+      # @param [string] id
+      # @param [string] description human-readable description of this Certificate Authority. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
+      # @return [NgrokAPI::Models::CertificateAuthority] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-update
+      def update(
+        id: "",
+        description: nil,
+        metadata: nil
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        result = @client.patch(path % replacements, data: data)
+        NgrokAPI::Models::CertificateAuthority.new(client: self, result: result)
+      end
+
+      ##
+      # Update attributes of a Certificate Authority by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id
+      # @param [string] description human-readable description of this Certificate Authority. optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
+      # @return [NgrokAPI::Models::CertificateAuthority] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-certificate-authorities-update
+      def update!(
+        id: "",
+        description: nil,
+        metadata: nil
+      )
+        path = '/certificate_authorities/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        result = @client.patch(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::CertificateAuthority.new(client: self, result: result)
+      end
+    end
+  end
+end