Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: added error codes

These endpoints allow users to manage device subscriptions on a network. 

Base URL for these endpoints:  https://api.bsn.cloud/2020/10/REST/Subscriptions/

_________________________________________________________________________

GET

Returns a list of device subscriptions

Query String Parameters

marker string optional

A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of device subscription instances exceeds the pageSize.

This parameter is only required if you need more elements in the paged list than the pageSize (100).


pageSize int optional

The maximum number of device subscription instances that can be contained in the response body. This defaults to the maximum allowed page size (100).

______________________________________________________________

Response Body

Success

200: Returns a paged list of device subscription entities on a network. This will return not more than 100 entities along with the information necessary to return any other remaining pages.

Failure

300: The device subscription entity is not specified correctly (there is more than one possible resource representation)

400: Either the request or the device subscription entity is invalid or not specified

401: The access token is invalid or not specified

403: The supplied access token, though valid, doesn't provide access to this method 

406: The specified representation of the device subscription entity is not acceptable

5XX: Any 500 code is an internal server error

Endpoints:

Table of Contents
maxLevel2
indent20px
excludeEndpoints:



Count/GET

Retrieves the number of subscription instances on the network matching the specified filter criteria. If no filter is included, this call returns the total number of subscription instances on the network. 

Query String Parameter

filter string

An expression for filtering search results. The default value is null.

______________________________________________________________

Response Body

Success

200: The subscription instance count is returned as an integer value.

Failure

300: The device subscription files are not specified correctly (there is more than one possible response)

400: Either the request or the device subscription entity is invalid or not specified

401: The access token is invalid or not specified

403: The supplied access token, though valid, doesn't provide access to this method 

406: The specified representation of the device subscription entity is not acceptable

5XX: Any 500 code is an internal server error

Operations/GET

Returns operational permissions granted to roles for specific business operations

Response Body

Success

200: Returns the Business Operations Entity

Failure

300: The business operations tree is not specified correctly (there is more than one possible response)

400: Either the request or the business operations tree is invalid or not specified

401: The access token is invalid or not specified

403: The supplied access token, though valid, doesn't provide access to this method 

406: The specified business operations tree is not acceptable

5XX: Any 500 code is an internal server error