Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
borderColor#3D3D3D
bgColor#F4F4F4
titleColor#3D3D3D
borderWidth0
titleBGColor#3D3D3D
borderStylesolid

ON THIS PAGE

Table of Contents
maxLevel3
indent20px

These endpoints allow users to manage their settings in the current BrightSignNetwork.com network.

/self/

GET

Gets the information associated with the user in the current network.

Parameters

  • Person : An array of information about a person in the network

Response Body

  • [int] Id: The user id
  • [string] Login: The user login name
  • [string] Email: The user login email
  • [string] Password: The user password
  • [string] FirstName: The first name of the user
  • [string] LastName: The last name of the user
  • [string] CreationDate: 

POST

Registers the user in the current BSN.cloud network. The server will return your person credentials, including an auto-generated password, which Postman will store.

Parameters

  • [returnURL] This parameter is optional. If it is not specified, the parameters value from BSN configuration file will be used.

Request Body

  • [int] Id:
  • [string] Login: The user login name
  • [string] Email: The user login email
  • [string] Password: The user password
  • [string] FirstName: The first name of the user
  • [string] LastName: The last name of the user
  • [string] CreationDate: 


Response Body

  • Person

PUT

Updates the users information in the current network.

Request Body

  • Person

Response Body

On success this method returns a status code 204, on failure it returns a status code of 500.

/self/profile

GET

Gets the users profile settings.

Response Body

  • Dictionary<string, string>

POST

Updates the users profile settings.

Request Body

  • KeyValuePair<string, string>

Response Body

  • KeyValuePair<string, string>

/self/profile/{key}

GET

Gets the users profile settings.

Response Body

  • String

PUT

Updates the users profile settings.

Request Body

  • String

Response Body

  • [KeyValuePair<string, string>]

DELETE

Deletes the users profile settings.

/self/networks/

GET

Retrieves all networks associated with the user.

Response Body


  • [int] id: The network id
  • [string] name:  The name of the network owner
  • [string] creationDate: The creation date of the network
  • [string] lockoutDate: The date on which the user was locked out, if applicable
  • [bool] isLockedOut: Whether the user is locked out
  • [string] lastLockoutDate: The last date on which the user was locked out, if applicable
  • settings
    • [string] userAccessTokenLifetime
    • [string] userRefreshTokenLifetime
    • [string] deviceAccessTokenLifetime
    • [string] deviceRefreshTokenLifetime
    • [string] deviceRegistrationTokenLifetime
    • [bool] automaticSubscriptionsManagementEnabled
    • [bool] automaticTaggedPlaylistApprovementEnabled
  • subscription
    • [int] id: The subscription id
    • [string] level: Whether the network is "Content" or "Control"
    • [string] creationDate: The creation date of the subscription
    • [string] lastModifiedDate: The last date on which the subscription was modified
    • [string] expireDate: The date on which the network subscription will expire

POST

This call creates a BSN.cloud network: The server will create a network with your credentials as the network owner.

Parameters

  • key

Request Body

  • [int] id: The network id
  • [string] name:  The name of the network owner
  • [string] creationDate: The creation date of the network
  • [string] lockoutDate: The date on which the user was locked out, if applicable
  • [bool] isLockedOut: Whether the user is locked out
  • [string] lastLockoutDate: The last date on which the user was locked out, if applicable
  • settings
    • [string] userAccessTokenLifetime
    • [string] userRefreshTokenLifetime
    • [string] deviceAccessTokenLifetime
    • [string] deviceRefreshTokenLifetime
    • [string] deviceRegistrationTokenLifetime
    • [bool] automaticSubscriptionsManagementEnabled
    • [bool] automaticTaggedPlaylistApprovementEnabled
  • subscription
Response Body
  • Network

/self/networks/{networkId}/

/self/networks/{networkName}/

GET

Retrieve the network name.

Request Body

  • Network

/self/networks/{networkId}/settings/

GET

Retrieve the network settings.

Response Body

  • Network Settings

/self/networks/{networkName}/settings/

PUT

Request Body

  • Network Settings

/self/networks/{networkId}/subscription/

/self/networks/{networkName}/subscription/

GET

Gets the network subscription information for the user.

Response Body

  • Network Subscription

/self/users/

GET

Gets the names of the user(s) on the current network

Response Body

  • User[]

/self/users/{userId}/

GET

Gets the id(s) of the users on the current network

Response Body

  • User

/self/users/{userId}/role

GET

Gets the role(s) of the users on the current network

Response Body

  • Role

If the user is not assigned to a role, then the expected response status is 204 (No content)

/self/users/{userId}/role/permissions

GET

Gets the role permissions of the users on the current network

Response Body

  • Permission[]
  • Dictionary<string, string>

If the user is not assigned to a role, then the expected response status is 200, with empty array ('[]' in case JSON format) as a body.

/self/users/{userId}/profile/

POST

Request Body

  • [KeyValuePair<string, string>]

Response Body

  • [KeyValuePair<string, string>]

/self/users/{userId}/profile/{key}

GET

Retrieve the user profile.

Response Body

  • String

PUT

Update the user profile.

Request Body

  • String

Response Body

  • [KeyValuePair<string, string>]

DELETE

Delete the user profile.

/self/users/{userId}/notifications/

GET

Get user notification settings.

Response Body

  • UserNotificationSettings

PUT

Update user notification settings.

Request Body

  • UserNotificationSettings


/self/users/{userId}/permissions/

GET

Get user permissions.

Response Body

  • Permission[]