Elixir SDK for Synq API

Welcome to the Elixir SDK for the Synq API. This is an implementation of the API specification. You can view the Elixir API reference here

Installation

Prerequesite

Elixir 1.4.x

Setup

SYNQ requires an API key for HTTP requests. Set the following env variable:

  SYNQ_API_KEY:your_api_key

Add SynqElixir to your list of dependencies in mix.exs:

  def deps do
    [{:synq_elixir, github: "SYNQfm/SYNQ-Elixir"}]
  end

Or from hex:

  def deps do
    [{:synq_elixir, "~> 0.0.2"}]
  end

Ensure you list synq_elixir in application dependency in your mix.exs file.

  [applications: [:synq_elixir]]

Examples

# Create video
{:ok, video} = SynqElixir.Api.create()

# Create video with video file
{:ok, {video, upload_headers}} = SynqElixir.Api.create("~/Downloads/myvideo.mp4")

# Create video with custom metadata
{:ok, video} = SynqElixir.Api.create(%{foo: "bar"})

# Create video with video file and metadata
{:ok, {video, upload_headers}} = SynqElixir.Api.create("~/Downloads/myvideo.mp4", %{foo: "bar"})

# Get video details for video 'video123'
{:ok, video} = SynqElixir.Api.details("video123")

# upload video file to the video object 'video123'
{:ok, upload_headers} = SynqElixir.Api.upload("video123", "~/Downloads/myvideo.mp4")

Video object looks like this

%SynqElixir.Resources.Video{
  created_at: "2017-02-15T03:01:16.767Z",
  updated_at: "2017-02-15T03:06:31.794Z",
  userdata: %{},
  player: %{
    "embed_url" => "https://player.synq.fm/embed/video123",
    "thumbnail_url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/thumbnails/45/d4/video123/0000360.jpg",
    "views" => 0},
  state: "uploaded",
  video_id: "video123",
  outputs: %{
    "hls" => %{
      "state" => "complete", "url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/videos/45/d4/video123/hls/video123_hls.m3u8"},
    "mp4_1080" => %{
      "state" => "complete", "url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/videos/45/d4/video123/mp4_1080/video123_mp4_1080.mp4"},
    "mp4_360" => %{
      "state" => "complete", "url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/videos/45/d4/video123/mp4_360/video123_mp4_360.mp4"},
    "mp4_720" => %{
      "state" => "complete", "url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/videos/45/d4/video123/mp4_720/video123_mp4_720.mp4"},
    "webm_720" => %{
      "state" => "complete", "url" => "https://multicdn.synq.fm/projects/0a/bf/0abfe1b849154082993f2fce77a16fd9/derivatives/videos/45/d4/video123/webm_720/video123_webm_720.webm"}}
  }

Upload Headers look like this

%{"x-amz-id-2" => "amz",
  "x-amz-request-id" => "122E97DAFA36213A",
  "Date" => "Tue, 14 Feb 2017 22:38:46 GMT",
  "ETag" => "\"123\"",
  "Location" => "https://synqfm.s3.amazonaws.com/projects%2F0a%2Fbf%2F0abfe1b849154082993f2fce77a16fd9%2Fuploads%2Fvideos%2Fac%2F87%video123.mp4",
  "Server" => "AmazonS3"
}

Usage

You can use the functions in SynqElixir.Api for making requests to RESTful api of Synq.fm. There are shorthand functions that wrap the common get requests

You can also run convenience tasks that will help you testing creating of videos

# create and upload video
mix synq_task -c create -f ~/Downloads/myvideo.mp4

# create a video object
mix synq_task -c create

# get details for video 123
mix synq_task -c details -v 123

# upload file to video object
mix synq_task -c upload -v 123 -f ~/Downloads/myvideo.mp4

Overriding Environment

By default, we’ll use the prod environment. You can override the default environment by exporting the environment variable SYNQ_ENV which can be set stage or prod

Compatability

We currently support Elixir 1.4.x, if you are on an older version, please use hex version 0.0.1

synq_elixir

v0.0.2