Introduction

Niche Video Media's APIs belong to the Representational State Transfer (REST) category.They allow you to perform 'RESTful' operations such as reading, modifying, adding or deleting data from your Private Media Channel. Absorb the APIs to generate reports and brand from your own service. No more hassle of having to log into your Private Media Channel to generate lists or reports.

Getting Started

To generate the API key, log in to your Private Media Channel and go to General Settings > API Credential. Click on the "Enable API Access" button and then generate your API key by clicking on the Create/Update button. Once you have generated the key do not forget to hit "Save".

If you wish to regenerate your API key, all you have to do is click on the Create/Update button again to generate an updated API key.

You can then use this API key to identify the program called. Voila! You're all set to brand the Private Media Channel from your own service.

Authentication

You must use SSL (https instead of http) to access the API.

Send the API key through the UserCredential header with each request.

For Example:

curl --header "UserCredential: {'APIKey':'APIKeyValue','HostName':'ChannelURL'}" https://api.nichevid.com/user/list

Upload Video

To upload a media file from your computer, supply the required parameters and POST your media file to https://api.nichevid.com/video/upload as multipart-form encoded data.

The uploaded media will be visible immediately in your account, but may require processing.

For Example:

curl -H "UserCredential: {'APIKey':'APIKeyValue', 'HostName':'ChannelURL'}" -F communityid=< communityid > -F title=< videotitle > -F file=@< LOCAL_FILE_PATH > https://api.nichevid.com/video/upload

We expect a multipart/form-data POST to the server with file, communityid, and UserCredential parameters. Feel free to add additional parameters, such as title and desccription.

Response Format

{
  "id": 1,
  "name": "Sample Video title",
  "type": "video",
  "created": "sample datetime string",
  "hashkey": "Hashed Value of ID",
  "communityid": "Community Video Belongs to"
}