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 BSN.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

...

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

Base URL for these endpoints:  https://api.brightsignnetwork.com/2017/01/REST/Self

GET  /

Returns the information associated with the person (the requestor).

Response Body

Returns thePerson Entity

PUT  /

Updates a person's information.

Request Body

The  Person Entity

______________________________________________________________

Response Body

On success this method returns a status code

...

2XX, on failure it returns a status code of

...

5XX.

GET  /

...

Networks/

...

 

GET

...

Returns the networks associated with a person

Response Body

  • Dictionary<string, string>

POST

...

Returns a complete list ofNetwork Entity instances associated with a person.

POST  /Networks/ 

Creates a network for the person.

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

...

TheNetwork Entity

______________________________________________________________

Response Body

Returns a 201 status code and the new resource created and referenced by the Uri (given by the Location header field) in the response. The response includes the network entity (see Network Entity).

GET  /Networks/{id:int}/ 

Returns a list of networks associated with a specified id.

Parameter

id int

The unique identifier for a network

______________________________________________________________

Response Body

Returns the Network Entity

GET  /Networks/{name}/ 

Returns a list of networks associated with a specified name.

Parameter

name string

The name of a network

______________________________________________________________

Response Body

Returns the Network Entity

GET  /Networks/{id:int}/Settings/ 

Returns the settings associated with a specified network.

Parameter

id int

The unique identifier for a network

______________________________________________________________

Response Body

Returns the Network Settings Entity

PUT  /Networks/{id:int}/Settings/ 

Update the settings associated with a specified network

Parameter

id  int

The network identifier

______________________________________________________________

Request Body

The Network Settings Entity

______________________________________________________________

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

GET  /Networks/{name}/Settings/ 

Get the settings associated with a specified network.

Parameter

name string

The network name

______________________________________________________________

Response Body

Returns the Network Settings Entity

PUT  /Networks/{name}/Settings/ 

Update the settings associated with a specified network

Parameter

id string

The network name

______________________________________________________________

Request Body

The Network Settings Entity

______________________________________________________________

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

GET  /Users/ 

Returns all user entities that the customer is associated with over all networks where the person has a user record

Response Body

Returns an array of user entities (see User Entity) if the user is a member of multiple networks, or to a single User Entity if the user is only a member of one network, or nothing if the user is not a member of any network.

GET  /Users/{userid:int}/ 

Returns information about a specified user on a network

Parameter

id int 

The unique identifier for a user

______________________________________________________________

Response Body

Returns the User Entity

GET  /Users/{userid:int}/Profile/ 

Returns the user profile settings

Parameter

id int

The unique identifier for a user

______________________________________________________________

Response Body

The return type is object, where property names are profile keys and the profile values are those property values

POST  /Users/{userid:int}/Profile/ 

Creates the user profile property

Parameter

id int

The unique identifier for a user

______________________________________________________________

Request Body

pair <string, string>

A key value pair. There should be not more than 100 properties per user, and each property value should be not more than 64KB. 

______________________________________________________________

Response Body

Returns a 201 status code, the key value pair, and a link to the GET method to retrieve it. 

GET  /Users/{userid:int}/Profile/{key}/ 

Returns the value of a user profile key

Parameters

id int

The unique identifier for the user

key  string

The name of the profile property

______________________________________________________________

Response Body

Returns the value of the requested user profile key 

PUT  /Users/{userid:int}/Profile/{key}/ 

Sets a property value in a user profile

Parameters

id int

The unique identifier for the user

key string

The name of the profile property

______________________________________________________________

Request Body

value string

The profile property value to update

______________________________________________________________

Response Body

Returns HTTP status code 201 if the property value is defined for first time, or status code 204 if the property already exists and has been updated.

DELETE  /Users/{userid:int}/Profile/{key}/ 

Removes a user profile property

Parameters

id int

The unique identifier for the user

key string

The name of the profile property

______________________________________________________________

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

GET  /Users/{userid:int}/Notifications/ 

Returns the user notification settings

Parameter

id int

The unique identifier for the user

______________________________________________________________

Response Body

Returns the User Notification Settings Entity

PUT  /Users/{userid:int}/Notifications/ 

Updates the user notification settings

Parameter

id int

The unique identifier for the user

______________________________________________________________

Request Body

The User Notification Settings Entity

______________________________________________________________

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

GET  /Users/{userid:int}/Permissions/ 

Returns permissions for a given user

Parameter

id int

The unique identifier for the user

______________________________________________________________

Response Body

Returns an array of Permission Entity entities

Endpoints:

Table of Contents
maxLevel2
indent20px
excludeEndpoints: