Welcome to the Zype API Documentation

Zype API documentation provides information to web developers who wish to use Zype’s Application Programming Interfaces (APIs). The Zype API includes modules for managing videos and associated metadata. In addition, this reference describes a number of related objects. The Zype API is a RESTful API service.

Our API is designed around standard REST CRUD (Create-Read-Update-Delete) semantics:

POST - Create a resource within a given collection

GET - Get a resource or collection of resources

PUT - Update a resource

DELETE - Delete a resource

Our default is to support JSON formatting, however if you prefer XML use the
Content-Type header with value text/xml.

Authentication

There are multiple ways to authenticate to the Zype API. Your Zype channels are
automatically set up with API keys that you can integrate with, but you can also use app keys and consumer access tokens to authenticate as well.

API Keys

Your Zype channel is automatically set up with the following API keys:

  • Admin Key: Admin keys have full access to your account and should not be distributed in video applications.
  • Read Only Key: Read only keys have limited access to your account and are not allowed to create or modify existing resources. Read only keys should be used when distributing a video application.
  • Player Key: Player keys have limited access to your account and are only allowed to issue player requests. Player keys should be used in embed codes for web applications.

Example

GET https://api.zype.com/videos?api_key=[api_key]

App Keys

App keys are automatically created when you set up new apps. App keys provide per app authentication so that each bundled app has separate credentials. App keys are automatically bundled using Zype app builders. App keys can be retrieved from your app's detail page.

Example:

GET https://api.zype.com/videos?app_key=[app_key]

Access Tokens

Access tokens provide per user authentication for API requests. Access tokens are time based tokens that are created using OAuth. Click here for more information about using OAuth.

Example:

GET https://api.zype.com/videos?access_token=[access_token]

Errors

Zype uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required r was missing, a charge failed, etc.), and codes in the 5xx range indicate an error with Zype's servers.

200 (OK)

The request was processed successfully.

401 (Unauthorized)

The request could not be processed because no API key was provided, or the API key provided is invalid.

404 (Not Found)

The request could not be processed because the resource you are operating on could not be found.

422 (Unprocessable Entity)

The request could not be processed due to a validation rule.

500 (Server Error)

The request could not be processed due to an error on Zype's servers.

Attributes:

message - A human-readable message giving more details about the error.

Pagination

Pagination is required for all 'list' requests. The default setting for any list request is to return 10 records.

Parameters

page (optional) The page number of records to return (zero indexed).

per_page (optional) The number of records to return (Default: 10, Maximum: 100).

Attributes

Paging data is returned in the 'pagination' element on list requests. The following data is made available.

current - The current page requested

previous - The page before the page requested.

next - The page after the page requested.

per_page - The maximum number of records returned.

pages - The total number of pages available.

Example:

{
  response: { ... },
  pagination: {
    current: 1,
    previous: null,
    next: 2,
    per_page: 10,
    pages: 5
  }
}

Video Formats

Videos published through the Zype platform support the following resolution and aspect ratios.

HLS (HTTP Live Streaming):

Resolution | Aspect | Width | Height

ResolutionAspectWidthHeight
240p16x9426px240px
360p16x9640px360px
480p16x9854px480px
720p16x91280px720px
1080p16x91920px1080px

WebM/MP4 Streaming:

To ensure compatibility with devices that do not support HLS, Zype provides WebM and MP4 streams.

FormatResolutionAspectWidthHeight
WebM360p16x9640px360px
MP4360p16x9640px360px

Video formats are optional and are configurable in the Zype Publisher dashboard.