API Changelog
April 26th, 2012 byBelow is our changelog for all updates to our API starting from April 26th, 2012. If anything changes with the API it will be updated here as well as our API documentation page.
November 27th, 2012
Login Object
- Add a new login object to support ‘viddler.logins.METHOD’ calls
Login Permissions Object
- Add a new login permissions object to support ‘viddler.logins.METHOD’ calls
New methods: viddler.logins.METHOD
- Added new methods to support mulit-user logins.
- viddler.logins.add
- viddler.logins.delete
- viddler.logins.get
- viddler.logins.list
- viddler.logins.update
Removed a few parameters from viddler.users.setProfile
- These were moved to login methods.
- Params removed were: first_name, last_name, email
July 18th, 2012
Video Objects
- Video objects are anytime information about a video is returned inside of a video tag. This could be with viddler.videos.getByUser, viddler.videos.getDetails, etc.
- Added ‘audio_only’ flag that tells you if the video only has an audio stream, inside of the standard video and audio stream. (1 = yes, 0 = no)
- Added ‘profile_name’ flag to the file array which will tell you if the file is the source file, 480p, 720p, etc)
Replaceable Video
- If you wish to replace a current video, you can now pass an input with the name of ‘video_id’ of the video’s id you wish to replace.
viddler.resellers.getSubaccounts (GET)
- Added param to sort subaccounts. Values include (“username-asc”, ”username-desc”, ”videos-asc”, ”videos-desc”, ”bandwidth-asc”, ”bandwidth-desc”, ”storage-asc”, ”storage-desc”)
viddler.videos.getByUser (GET)
- Added flag for total videos named ‘total’
- Added new sort options (title-asc and title-desc)
viddler.encoding.getStatus2
- Added the ability to pass the ‘video_id’ to the call to get status of just one video.
viddler.videos.setDetails (POST)
- Added ability to bulk append tags to multiple videos. If multiple video ids are submitted and tags are sent, they are appended to videos selected instead of replacing tags. Sending a single video_id will replace all current tags with what is in the tags variable.
- Added new option to ‘remove_tags’
viddler.playlists.getDetails (GET)
- Added flag for total videos named ‘total’
viddler.videos.upload (POST)
- Removed, please use viddler.videos.prepareUpload
viddler.encoding.getSettings (GET)
- Encoding profile names have changed to align with video standards (480p, 720p, 1080p, etc)
- added ‘allowed_bitrates’ which shows you which bitrate settings are accepted per encoding profile
viddler.users.getSettings (GET)
- Added ‘delivery_methods’ flag which shows the different delivery methods you have access to
- Added ‘video_delivery_method’ flag which shows which delivery method is set on your account (0 = progressive, 1 = streaming, 3 = adaptive bitrate)
- Added ‘replacable_video’ flag to show if this feature is enabled on your account or not (0 = No, 1 = Yes)
viddler.users.setSettings (POST)
- Added ‘video_delivery_method’ param which allows you to set your video delivery method (0 = progressive, 1 = streaming, 2 = adaptive bitrate)
- Added ‘default_tags’ param which allows you to set a comma delimited list of default tags to be set on all newly uploaded videos.
April 26th, 2012
HTTPS:443 Support Updated
- HTTPS support has been added to every method
- Formally could only be used for viddler.users.auth and viddler.users.register
viddler.encoding.getSettings (GET)
- removed flag for ‘encoding_settings.respect_source_dimension’
- added flag for ‘encoding_settings.use_source_for_playback’ – This flag determines if source file uploaded will be used for both Flash and HTML5 playback (if provided source is in proper format)
- Read the documentation for this method
viddler.encoding.setSettings (POST)
- removed param for ‘respect_source_dimension’
- added param for ‘use_source_for_playback’ – Not all accounts will have access to toggle this setting
- Read the documentation for this method
viddler.videos.addClosedCaptioning (POST)
- Add this new method
- Used for adding closed captioning file(s) to a specific video. Max file size is 1MB.
- Parameters: video_id, language, default, closed_captioning_url
- Read the documentation for this method
viddler.videos.delClosedCaptioning (POST)
- Add this new method
- Used for removing a particular CC file
- Parameters: closed_captioning_id
- Read the documentation for this method
viddler.videos.setClosedCaptioning (POST)
- Add this new method
- Used for updating a particular CC file
- Parameters: closed_captioning_id, language, enabled, default
- Read the documentation for this method
viddler.videos.comments.get (GET)
- Add this new method
- Used for getting comments for a specific video
- Parameters: video_id, parent_id, sort, page, per_page
- Read the documentation for this method
viddler.videos.setDetails (POST)
- Added new param for thumbnail_index
- Used to update the current video with a new thumbnail generated from Viddler’s thumbnail system
- Read the documentation for this method
viddler.videos.getDetails (GET)
- Added new return for thumbnail_index and thumbnail_count
- Used to figure out how many thumbnails were generated for current video as well as which one is active
- Read the documentation for this method
viddler.videos.getByUser (GET)
- Added new options to visibility argument (invite=Invite Only, embed=Domain Restricted)
- Read the documentation for this method