sdksio-verizon-apis-sdk 1.6.0 → 1.7.0

data/lib/verizon/controllers/service_profiles_controller.rb

@@ -0,0 +1,164 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # ServiceProfilesController
+  class ServiceProfilesController < BaseController
+    # Creates a service profile that describes the resource requirements of a
+    # service.
+    # @param [ResourcesServiceProfile] body Required parameter: The request body
+    # passes all of the needed parameters to create a service profile.
+    # Parameters will be edited here rather than the **Parameters** section
+    # above. The `maxLatencyMs` and `clientType` parameters are both required in
+    # the request body. **Note:** The `maxLatencyMs` value must be submitted in
+    # multiples of 5. Additionally, "GPU" is future functionality and the values
+    # are not captured.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def create_service_profile(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/serviceprofiles',
+                                     Server::EDGE_DISCOVERY)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(CreateServiceProfileResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'HTTP 400 Bad Request.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('401',
+                                 'HTTP 401 Unauthorized.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('default',
+                                 'HTTP 500 Internal Server Error.',
+                                 EdgeDiscoveryResultException))
+        .execute
+    end
+
+    # List all service profiles registered under your API key.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def list_service_profiles
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/serviceprofiles',
+                                     Server::EDGE_DISCOVERY)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ListServiceProfilesResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'HTTP 400 Bad Request.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('401',
+                                 'HTTP 401 Unauthorized.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('default',
+                                 'HTTP 500 Internal Server Error.',
+                                 EdgeDiscoveryResultException))
+        .execute
+    end
+
+    # Returns a specified service profile.
+    # @param [String] service_profile_id Required parameter: Example:
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def get_service_profile(service_profile_id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/serviceprofiles/{serviceProfileId}',
+                                     Server::EDGE_DISCOVERY)
+                   .template_param(new_parameter(service_profile_id, key: 'serviceProfileId')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ResourcesServiceProfileWithId.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'HTTP 400 Bad Request.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('401',
+                                 'HTTP 401 Unauthorized.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('default',
+                                 'HTTP 500 Internal Server Error.',
+                                 EdgeDiscoveryResultException))
+        .execute
+    end
+
+    # Update the definition of a Service Profile.
+    # @param [String] service_profile_id Required parameter: Example:
+    # @param [ResourcesServiceProfile] body Required parameter: The request body
+    # passes the rest of the needed parameters to create a service profile. The
+    # `maxLatencyMs` and `clientType` parameters are both required in the
+    # request body. **Note:** The `maxLatencyMs` value must be submitted in
+    # multiples of 5. Additionally, "GPU" is future functionality and the values
+    # are not captured. Default values to use are shown.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def update_service_profile(service_profile_id,
+                               body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/serviceprofiles/{serviceProfileId}',
+                                     Server::EDGE_DISCOVERY)
+                   .template_param(new_parameter(service_profile_id, key: 'serviceProfileId')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(UpdateServiceProfileResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'HTTP 400 Bad Request.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('401',
+                                 'HTTP 401 Unauthorized.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('default',
+                                 'HTTP 500 Internal Server Error.',
+                                 EdgeDiscoveryResultException))
+        .execute
+    end
+
+    # Delete Service Profile based on unique service profile ID.
+    # @param [String] service_profile_id Required parameter: Example:
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def delete_service_profile(service_profile_id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/serviceprofiles/{serviceProfileId}',
+                                     Server::EDGE_DISCOVERY)
+                   .template_param(new_parameter(service_profile_id, key: 'serviceProfileId')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DeleteServiceProfileResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'HTTP 400 Bad Request.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('401',
+                                 'HTTP 401 Unauthorized.',
+                                 EdgeDiscoveryResultException)
+                    .local_error('default',
+                                 'HTTP 500 Internal Server Error.',
+                                 EdgeDiscoveryResultException))
+        .execute
+    end
+  end
+end

data/lib/verizon/controllers/session_management_controller.rb

@@ -0,0 +1,78 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # SessionManagementController
+  class SessionManagementController < BaseController
+    # Initiates a Connectivity Management session and returns a VZ-M2M session
+    # token that is required in subsequent API requests.
+    # @param [LogInRequest] body Optional parameter: Request to initiate a
+    # session.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def start_connectivity_management_session(body: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/session/login',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('thingspace_oauth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(LogInResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+
+    # Ends a Connectivity Management session.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def end_connectivity_management_session
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/session/logout',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(LogOutRequest.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+
+    # The new password is effective immediately. Passwords do not expire, but
+    # Verizon recommends changing your password every 90 days.
+    # @param [SessionResetPasswordRequest] body Required parameter: Request with
+    # current password that needs to be reset.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def reset_connectivity_management_password(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/m2m/v1/session/password/actions/reset',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SessionResetPasswordResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+  end
+end

data/lib/verizon/controllers/sim_actions_controller.rb

@@ -0,0 +1,136 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # SIMActionsController
+  class SIMActionsController < BaseController
+    # System assign a new activation code to reactivate a deactivated device.
+    # **Note:** the previously assigned ICCID must be used to request a new
+    # activation code.
+    # @param [ESIMProfileRequest2] body Required parameter: Device Profile
+    # Query
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def newactivatecode(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/devices/profile/actions/renew_activation_code',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ESIMRequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 ESIMRestErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized',
+                                 ESIMRestErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ESIMRestErrorResponseException)
+                    .local_error('404',
+                                 'Not Found / Does not exist',
+                                 ESIMRestErrorResponseException)
+                    .local_error('406',
+                                 'Format / Request Unacceptable',
+                                 ESIMRestErrorResponseException)
+                    .local_error('429',
+                                 'Too many requests',
+                                 ESIMRestErrorResponseException)
+                    .local_error('default',
+                                 'Error response',
+                                 ESIMRestErrorResponseException))
+        .execute
+    end
+
+    # Uses the profile to activate the SIM.
+    # @param [ESIMProfileRequest] body Required parameter: Device Profile
+    # Query
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def setactivate_using_post(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/devices/profile/actions/activate',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ESIMRequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 ESIMRestErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized',
+                                 ESIMRestErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ESIMRestErrorResponseException)
+                    .local_error('404',
+                                 'Not Found / Does not exist',
+                                 ESIMRestErrorResponseException)
+                    .local_error('406',
+                                 'Format / Request Unacceptable',
+                                 ESIMRestErrorResponseException)
+                    .local_error('429',
+                                 'Too many requests',
+                                 ESIMRestErrorResponseException)
+                    .local_error('default',
+                                 'Error response',
+                                 ESIMRestErrorResponseException))
+        .execute
+    end
+
+    # Uses the profile to deactivate the SIM.
+    # @param [ProfileRequest2] body Required parameter: Device Profile Query
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def setdeactivate_using_post(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/devices/profile/actions/deactivate',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ESIMRequestResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request',
+                                 ESIMRestErrorResponseException)
+                    .local_error('401',
+                                 'Unauthorized',
+                                 ESIMRestErrorResponseException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 ESIMRestErrorResponseException)
+                    .local_error('404',
+                                 'Not Found / Does not exist',
+                                 ESIMRestErrorResponseException)
+                    .local_error('406',
+                                 'Format / Request Unacceptable',
+                                 ESIMRestErrorResponseException)
+                    .local_error('429',
+                                 'Too many requests',
+                                 ESIMRestErrorResponseException)
+                    .local_error('default',
+                                 'Error response',
+                                 ESIMRestErrorResponseException))
+        .execute
+    end
+  end
+end

data/lib/verizon/controllers/sim_secure_for_io_t_licenses_controller.rb

@@ -0,0 +1,94 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # SIMSecureForIoTLicensesController
+  class SIMSecureForIoTLicensesController < BaseController
+    # Assigns SIM-Secure for IoT licenses to SIMs.
+    # @param [AssignLicenseRequest] body Required parameter: Request to assign
+    # license to devices.
+    # @param [String] x_request_id Optional parameter: Transaction Id.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def assign_license_to_devices(body,
+                                  x_request_id: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/devices/license/actions/assign',
+                                     Server::M2M)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter(x_request_id, key: 'X-Request-ID'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SecuritySuccessResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 SecurityResultException)
+                    .local_error('401',
+                                 'Unauthorized request.',
+                                 SecurityResultException)
+                    .local_error('403',
+                                 'Request Forbidden.',
+                                 SecurityResultException)
+                    .local_error('404',
+                                 'Not Found / Does not exist.',
+                                 SecurityResultException)
+                    .local_error('406',
+                                 'Format / Request Unacceptable.',
+                                 SecurityResultException)
+                    .local_error('429',
+                                 'Too many requests.',
+                                 SecurityResultException)
+                    .local_error('default',
+                                 'Error response.',
+                                 SecurityResultException))
+        .execute
+    end
+
+    # Unassigns SIM-Secure for IoT Flexible and Flexible Bundle license from
+    # SIMs.
+    # @param [String] x_request_id Required parameter: Transaction Id.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def unassign_license_to_devices(x_request_id)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v1/devices/license/actions/assign',
+                                     Server::M2M)
+                   .header_param(new_parameter(x_request_id, key: 'X-Request-ID'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SecuritySuccessResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Bad request.',
+                                 SecurityResultException)
+                    .local_error('401',
+                                 'Unauthorized request.',
+                                 SecurityResultException)
+                    .local_error('403',
+                                 'Request forbidden.',
+                                 SecurityResultException)
+                    .local_error('404',
+                                 'Not Found / Does not exist.',
+                                 SecurityResultException)
+                    .local_error('406',
+                                 'Format / Request Unacceptable.',
+                                 SecurityResultException)
+                    .local_error('429',
+                                 'Too many requests.',
+                                 SecurityResultException)
+                    .local_error('default',
+                                 'Error response.',
+                                 SecurityResultException))
+        .execute
+    end
+  end
+end

data/lib/verizon/controllers/sms_controller.rb

@@ -0,0 +1,88 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # SMSController
+  class SMSController < BaseController
+    # The messages are queued on the ThingSpace Platform and sent as soon as
+    # possible, but they may be delayed due to traffic and routing
+    # considerations.
+    # @param [SMSSendRequest] body Required parameter: Request to send SMS.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def send_sms_to_device(body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/m2m/v1/sms',
+                                     Server::THINGSPACE)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DeviceManagementResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+
+    # When HTTP status is 202, a URL will be returned in the Location header of
+    # the form /sms/{aname}/history?next={token}. This URL can be used to
+    # request the next set of messages.
+    # @param [String] aname Required parameter: Account name.
+    # @param [Integer] mnext Optional parameter: Continue the previous query
+    # from the URL in Location Header.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def list_devices_sms_messages(aname,
+                                  mnext: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/m2m/v1/sms/{aname}/history',
+                                     Server::THINGSPACE)
+                   .template_param(new_parameter(aname, key: 'aname')
+                                    .should_encode(true))
+                   .query_param(new_parameter(mnext, key: 'next'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(SMSMessagesQueryResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+
+    # Tells the ThingSpace Platform to start sending mobile-originated SMS
+    # messages through the EnhancedConnectivityService callback service. SMS
+    # messages from devices are queued until they are retrieved by your
+    # application, either by callback or synchronously with GET
+    # /sms/{accountName}/history.
+    # @param [String] aname Required parameter: Account name.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def start_queued_sms_delivery(aname)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/m2m/v1/sms/{aname}/startCallbacks',
+                                     Server::THINGSPACE)
+                   .template_param(new_parameter(aname, key: 'aname')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ConnectivityManagementSuccessResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Error response.',
+                                 ConnectivityManagementResultException))
+        .execute
+    end
+  end
+end

data/lib/verizon/controllers/software_management_callbacks_v1_controller.rb

@@ -0,0 +1,93 @@
+# verizon
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module Verizon
+  # SoftwareManagementCallbacksV1Controller
+  class SoftwareManagementCallbacksV1Controller < BaseController
+    # Returns the name and endpoint URL of the callback listening services
+    # registered for a given account.
+    # @param [String] account Required parameter: Account identifier in
+    # "##########-#####".
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def list_registered_callbacks(account)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/callbacks/{account}',
+                                     Server::SOFTWARE_MANAGEMENT_V1)
+                   .template_param(new_parameter(account, key: 'account')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(RegisteredCallbacks.method(:from_hash))
+                    .is_api_response(true)
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Unexpected error.',
+                                 FotaV1ResultException))
+        .execute
+    end
+
+    # Registers a URL to receive RESTful messages from a callback service when
+    # new firmware versions are available and when upgrades start and finish.
+    # @param [String] account Required parameter: Account identifier in
+    # "##########-#####".
+    # @param [FotaV1CallbackRegistrationRequest] body Required parameter:
+    # Callback details.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def register_callback(account,
+                          body)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/callbacks/{account}',
+                                     Server::SOFTWARE_MANAGEMENT_V1)
+                   .template_param(new_parameter(account, key: 'account')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(FotaV1CallbackRegistrationResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Unexpected error.',
+                                 FotaV1ResultException))
+        .execute
+    end
+
+    # Deregisters the callback endpoint and stops ThingSpace from sending FOTA
+    # callback messages for the specified account.
+    # @param [String] account Required parameter: Account identifier in
+    # "##########-#####".
+    # @param [CallbackServiceEnum] service Required parameter: Callback type.
+    # Must be 'Fota' for Software Management Services API.
+    # @return [ApiResponse]  the complete http response with raw body and status code.
+    def deregister_callback(account,
+                            service)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/callbacks/{account}/name/{service}',
+                                     Server::SOFTWARE_MANAGEMENT_V1)
+                   .template_param(new_parameter(account, key: 'account')
+                                    .should_encode(true))
+                   .template_param(new_parameter(service, key: 'service')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('thingspace_oauth', 'VZ-M2M-Token')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(FotaV1SuccessResult.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Unexpected error.',
+                                 FotaV1ResultException))
+        .execute
+    end
+  end
+end