Overview

Introduction

The Viously API is a simple way to read and write data on Viously.
It presents a simple, consistent view of the Viously objects (e.g., videos) and connections between them (e.g., external id).

Our API is served over HTTPS, on the following endpoint: https://api.viously.com/v2.

Getting started

In order to use the API, make sure you have the right to access the API feature in your account.

To do so:

  • Login on Viously.
  • Check that you have the API feature (2) in your Account section (1).
  • If you don't, contact your account manager or the support team.
How to find my credentials?

How to find my credentials?

Once this verification is done, get a token to be able to perform actions in the API.

Connections by HTTP and HTTPS

By default, access to the API is over HTTPS only and HTTP access is not permitted. An attempt to access any of the API endpoints HTTP will result in a 403 Forbidden error.

Security

API keys and api secrets should never be shared or made public:
API secrets should never be used where they could be discovered by other users, such as in client-side files or in local storage for mobile applications. Otherwise, anyone with a little technical knowledge can potentially access them.
Similarly, token should be kept private and stored in secured locations.