Error code management on clients

Signin 

New user

An operator creates a new user in OpCon and the user attempts to log in with the new credentials.

• User should be able to login with the credentials provided by the operator.

HTTP code : 200 ( Valid credentials. )

HTTP code : 401 ( Invalid credentials. )

Success → User is logged in to the application.

Failure → On screen message.

Incorrect username or password. Please try again.

A user logs in for the first time. A new device is created at account level.

N/A

Can be verified through OpCon.

Further logout/login actions on the device should not create new devices.

N/A

A user logs in for the first time. A new device is created at account level. Access authentication fails due to the user using a Proxy or VPN.

403 - Forbidden - code(20021)

Access was via a restricted proxy - Geo-Blocking check.

An error occurred. Please contact the operator. (20021)

A user logs in for the first time with a new device. A new device is created at account level. Access authentication fails due to the user's location.

403 - Forbidden - code(20022)

Access was via a restricted country - Geo-Blocking check.

An error occurred. Please contact the operator. (20022)

Existing user

A user logs in to the account on a device and performs one of the following actions on the system.

• Uninstalls the application.

• Removes the application data in the browser/native system.

N/A

A new device is created against the user's account on the backend. 

An operator can delete or disable the device.

N/A

An operator disables the device that the user is using to access content.

• If content is being played, the session should stop and log out the user. (Note that the client will only discover this on access token refresh.)

• Further attempts by the user to log in on the device would result in an error.

403 - Forbidden - code(20004)

If a device was disabled in error, the application needs to be removed and reinstalled.

This device has been disabled. Please contact the operator. (20004)

An operator deletes the device that the user is using to access content.

• If content is being played, the session should stop and log out the user. (Note that the client will only discover this on access token refresh.)

• Further attempts by the user to log in on the device would result in an error.

403 - Forbidden - code(20003)

Deleted device does not exist.

This device has been removed from your account. Please contact the operator. (20003)

An operator suspends the account that the user is using to access content.

• If content is being played, the session should stop and logout the user. (Note that the client will only discover this on access token refresh.)

• Further attempts by the user to log in on the device would result in an error.

403 - Forbidden - code(20002)

Account suspended by operator. This situation can be reversed.

Account suspended. Please contact the operator. (20002)

An operator cancels the account that the end-user is using to access content.

• If content is being played, the session should stop and logout the user.

• Further attempts by the user to log in on the device would result in an error.

403 - Forbidden - code(20001)

Account cancelled by operator. This situation can be reversed.

Account cancelled. Please contact the operator. (20001)

A user attempts to log in when the maximum number of devices are in use for the account.

403 - Forbidden - code(20007)

Maximum number of devices reached for account.

An error occurred. Please contact the operator. (20007)

The user attempts to log in or playback content using a Proxy or VPN

403 - Forbidden - code(20018)

Triggered if VPN Blocking is enabled on the platform.

An error occurred. Please contact the operator. (20018)

User attempts to log in or playback content from a blacklisted location.

403 - Forbidden - code(20019)

Triggered if geo-blocking is enabled on the platform.

An error occurred. Please contact the operator. (20019)

User attempts to log in or playback content and the token validity check fails.

403 - Forbidden - code(20020)

User attempts to log in or playback content and the token validity check fails.

An error occurred, please contact the operator. (20020)

User attempts to log in or playback content from a geo filtered location.

403 - Forbidden - code(20066)

User attempts to log on or playback content that is filtered out by Geo Filtering.

An error occurred. Please contact the operator. (20066)

User's device tries to auto sign in.

Auto sign in failure happens and login screen is displayed on box boot up.

Auto sign in failed. Please authenticate with username and password.

Player

Playback error scenarios

The given video format is not supported by the player.

Code 1002

User attempts to play content in format which is not supported by player.

An error has occurred. Please try again later or select another programme. (1002)

The URL is either not available or the format is not supported by the player

Code 1003

User attempts to play content with unsupported URL.

An error has occurred. Please try again later or select another programme. (1003)

The manifest or segment not found. 

Code 1004

User attempts to play encrypted content.

An error has occurred. Please try again later or select another programme. (1004)

The content is encrypted and we do not have the keys to decrypt it.

Code 1005

User attempts to play encrypted content.

An error has occurred. Please try again later or select another programme. (1005)

The user attempts to play content that they're not subscribed to.

Code 1006

User attempts to play unsubscribed content.

You are not subscribed to Channel. Call X-XXX to subscribe.

The user attempts to play content that they're not authorised to play.

Code 1007

User attempts to play unauthorised content.

An error has occurred. Please try again later or select another programme. (1007)

There is an error when attempting to get the content authorisation token.

Code 1008

User attempts to play content with expired token.

Failed to retrieve a content token.

Maximum number of streaming devices reached.

N/A

User attempts to play content on more devices than allowed for streaming.

Sorry, your service subscription only allows for "n" devices at a time.
To continue watching, close any videos you may be watching on other devices or try again later.

The player licence has expired.

code: -1351

User attempts to play content when the application's player license has expired.

An error has occurred. Please try again later or select another programme. (-1351)

Player error when session management set up has failed.

code: -1352

User attempts to play content when session management has failed.

An error has occurred. Please try again later or select another programme. (-1352)

Player error on session management renewal failure.

code: -1353

User attempts to play content when session management renewal has failed.

An error has occurred. Please try again later or select another programme. (-1353)

Player error on session management teardown failure.

code: -1354

User attempts to play content and SSM teardown failure happens.

An error has occurred. Please try again later or select another programme. (-1354)

The player is unable to decrypt the content's DRM.

code: -1355

User attempts to play content and DRM decryption failure happens.

An error has occurred. Please try again later or select another programme. (-1355)

The player does not support the content's DRM variant.

code: -1356

User attempts to play content and DRM not supported.

An error has occurred. Please try again later or select another programme. (-1356)

Player is unable to decode the content.

code: -1357

User attempts to play content and decoder error happens.

An error has occurred. Please try again later or select another programme. (-1357)

The player's license key has expired.

code: -1358

User attempts to play content and license key is expired.

An error has occurred. Please try again later or select another programme. (-1358)

Player is unable to get a licence for the session.

code: -1359

User attempts to play content and license session failure happens.

An error has occurred. Please try again later or select another programme. (-1359)

Player error on license scheme data failure.

code: -1360

User attempts to play content and license scheme data failure happens

An error has occurred. Please try again later or select another programme. (-1360)

Player error on DRM session failure.

code: -1361

User attempts to play content and DRM session failure happens.

An error has occurred. Please try again later or select another programme. (-1361)

Issue with the DRM server.

code: -3100

User attempts to play content and SSP fails.

An error has occurred. Please try again later or select another programme. (-3100)

Playback provisioning error.

code: -3200

User attempts to play content and the playback is not provisioned.

An error has occurred. Please try again later or select another programme. (-3200)

Playback content failed on same content token retry.

code: 4006

User attempts to play content on token retry.

An error has occurred. Please try again later or select another programme. (4006)

Network

App is used without network connection.

N/A

When user attempts to use app without internet connectivity.

No internet detected. Operation of this service requires network connection.