Welcome to the Nudgis API documentation¶
This document specifies the Nudgis API; a reference python-based client is available here: https://github.com/UbiCastTeam/mediaserver-client
In all API, CSV or RSS requests, you can use an API key to be authenticated. The API key can be found on the user account edit page or in the
my profile page for your account.
The API key argument should be given in a request header named
api-key. For compatibility with older versions of the API and to allow usage with some tools that don’t support to set headers, the
api_key argument can also be given in the url query string (
?api_key=X) or in the data (
api_key=X) for POST requests.
All request data should be encoded using
multipart/form-data when some files are sent.
All responses data are encoded using UTF-8.
All response data is formatted as json. All requests are either HTTP GET or POST.
In this documentation, arguments between brackets (like
[oid]) are optional.
Any failed call will return a status code greater than or equal 400.
Common fields are :
Error description message when the request has failed.
List of errors (only in some calls).
URL construction rules¶
Most of the API response data will not contain direct links or embed data, but provides a media identifier, which is a unique identifier of the video. The on-demand video ids are prefixed with the letter
v, live streams by the letter
l, photos groups by the letter
p, and channels by the letter
For instance, the video at: https://ubicast.tv/videos/rich-media-ubicast/ has the identifier
It allows to build the following urls:
- A permanent url pointing to the media:
- An iframe url, containing only the player:
- An iframe url, containing only the player with the sidebar hidden:
- Another iframe url, containing the editor:
Note that the string
rich-media-ubicast is called the slug, and can be edited by the users.
Throughout this documentation,
channel is used to target a specific channel (when creating a live stream for example).
Channels have a maximum recursion level of 5 (it means that a channel can have 5 parents at most).
This argument can take the following values:
The channel with the slug matching to the
room-3for the example) will be picked or created if not found. The channel will be first searched by slug (
slugifiedtitle) and then by title. If several channels have the same title and no slug matches the
slugifiedtitle, a random one among results will be picked.
The unique identifier of the channel (20 characters beginning with
cand containing only letters and digits), see previous section.
mscpath-Main channel title/Sub channel title/Test channel title
The suffix is parsed and splitted on
/(hence, this character should not be used in the channel titles), and defines the path of the channels which will be recursively created if needed. The channels will be first searched by slug (
slugifiedtitle) and then by title. If several channels have the same title and no slug matches the slugified title, a random one among results will be picked.
The suffix is an external reference field, used for special integration purposes.
Used to target speaker’s personal channel. The
speaker_idfields should be filled in metadata. If the speaker’s account does not have the permission to have a personal channel or if the speaker’s information are not given, the default channel will be used.
- API calls
- Default settings
- Home page widgets
- Live streams
- Media resources
- Recorders control
- Resources routing rules
- Server status
- Tasks on media