Users

Register a new user

curl command

$ curl 'http://platform.wim.tv:8080/api/public/user/register' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "password" : "secr3t",
  "userCode" : "jane",
  "firstName" : "Jane",
  "lastName" : "Doe",
  "birthDate" : "10/02/1971",
  "email" : "jane@cedeo.net",
  "passwordConfirm" : "secr3t",
  "conditionsAccepted" : true,
  "language" : "en",
  "activationUrl" : "http://platform.wim.tv/activate?token=${token}"
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

userCode

String

The user code.

* Required.
* Length must be between 4 and 50 inclusive.
* Must match the regular expression [a-zA-Z](\.[a-zA-Z][a-zA-Z0-9])*.
* Must not be blank.

password

String

The password to assign to the user.

* Required.
* Must not be blank.

passwordConfirm

String

Must be set with the same password set in the password field.

* Required.
* Must not be blank.

firstName

String

First name.

* Required.
* Length must be between 0 and 64 inclusive.
* Must not be blank.

lastName

String

Last name.

* Required.
* Length must be between 0 and 64 inclusive.
* Must not be blank.

birthDate

Date

Birth date.

* Required.
* Must not be null.
* The birth date must be at least 18 years before today..

email

String

E-mail.

* Required.
* Length must be between 0 and 128 inclusive.
* Must be a well-formed email address.
* Must not be blank.

language

String

Language chosen by the user for sending emails

* Required.
* Must not be blank.

conditionsAccepted

Boolean

Whether the user has accepted the service conditions or not.

* Required.
* Must be true.

activationUrl

URI

Template URL to user activation page. The procedure replaces all occurrences of the variable ${token} with the authentication token.

* Must be set only if the client enables the user activation process.

Response

HTTP/1.1 201 Created
Content-Length: 314
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "vodPublic" : true
  },
  "userCode" : "jane",
  "finance" : {
    "billingAddress" : { }
  },
  "profile" : {
    "firstName" : "Jane",
    "lastName" : "Doe",
    "birthDate" : "10/02/1971",
    "email" : "jane@cedeo.net",
    "language" : "en"
  }
}

Response fields

See Read the logged user.

Activate a new user

curl command

$ curl 'http://platform.wim.tv:8080/api/public/user/activate?token=d2e862a9-5306-467b-a4d9-ab854a2ee564' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request headers

Name Description

Accept

application/json

* Required.

Request parameters

Parameter Description

token

The activation token.

Response

HTTP/1.1 200 OK
Content-Length: 314
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "vodPublic" : true
  },
  "userCode" : "jane",
  "finance" : {
    "billingAddress" : { }
  },
  "profile" : {
    "firstName" : "Jane",
    "lastName" : "Doe",
    "birthDate" : "10/02/1971",
    "email" : "jane@cedeo.net",
    "language" : "en"
  }
}

Response fields

See Read the logged user.

Read the logged user

curl command

$ curl 'http://platform.wim.tv:8080/api/user/me' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 887
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "livePassword" : "xXx",
    "vodPublic" : true
  },
  "userCode" : "john",
  "finance" : {
    "companyName" : "WimLabs",
    "billingAddress" : {
      "street" : "Piazza De Amicis 121 bis",
      "zipCode" : "10126",
      "city" : "Torino",
      "country" : "IT",
      "countryName" : "Italy",
      "state" : "Torino"
    },
    "vatNumber" : "10539730019",
    "paypalEmail" : "john@cedeo.net"
  },
  "profile" : {
    "thumbnailId" : "04cae6cd-55b7-40ee-92d6-75bc0549f00a",
    "firstName" : "John",
    "lastName" : "Doe",
    "birthDate" : "26/02/1972",
    "email" : "john@cedeo.net",
    "language" : "IT",
    "pageTitle" : "WimTV",
    "pageDescription" : "Test API",
    "facebookUrl" : "http://www.facebook.com/wimtv",
    "twitterContact" : "@wimtv",
    "linkedinUrl" : "http://www.linkedin.com/wimtv"
  }
}

Response fields

Path Type Description

userCode

String

The user code.

profile

Profile

The user profile.

finance

Finance

The user finance profile.

features

Features

The user features setting.

User profile

Path Type Description

firstName

String

First name.

lastName

String

Last name.

birthDate

Date

Birth date.

pageTitle

String

Page title. May be not provided.

pageDescription

String

Page description. May be not provided.

thumbnailId

String

Identifier of the thumbnail assigned to the user. May be not provided.

email

String

E-mail.

facebookUrl

String

Facebook profile URL. May be not provided.

twitterContact

String

Twitter contact. May be not provided.

linkedinUrl

String

LinkedIn profile URL. May be not provided.

User financial profile

Path Type Description

paypalEmail

String

PayPal account. May be not provided.

companyName

String

Company in the name of which the user deals. May be not provided.

taxCode

String

Tax code. May be not provided.

vatNumber

String

VAT number. May be not provided.

billingAddress

Address

Billing address. May be not provided.

User features settings

Path Type Description

transcoderNotifyEnabledField

Boolean

Whether the user would like to receive notifications about the transcoding process.

vodPublic

Boolean

Whether the WimVod items should be visible in public pages. See Searches for WimVod items in public pages.

livePassword

String

The password for WimLive services. May be not provided.

Disable the logged user

A logged user can disable his own account.

curl command

$ curl 'http://platform.wim.tv:8080/api/user/me/disable' -i -X POST \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json'

Request headers

Name Description

Content-Type

application/json

* Required.

Response

HTTP/1.1 204 No Content

Update the logged user

curl command

$ curl 'http://platform.wim.tv:8080/api/user/me' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "livePassword" : "xXx",
    "vodPublic" : true
  },
  "finance" : {
    "companyName" : "WimLabs",
    "companyConfirm" : true,
    "billingAddress" : {
      "street" : "Piazza De Amicis 121 bis",
      "zipCode" : "10126",
      "city" : "Torino",
      "country" : "IT",
      "state" : "Torino"
    },
    "vatNumber" : "10539730019",
    "paypalEmail" : "john@cedeo.net"
  },
  "profile" : {
    "thumbnailId" : "04cae6cd-55b7-40ee-92d6-75bc0549f00a",
    "firstName" : "John",
    "lastName" : "Doe",
    "birthDate" : "26/02/1972",
    "email" : "john@cedeo.net",
    "language" : "IT",
    "pageTitle" : "WimTV",
    "pageDescription" : "Test API",
    "facebookUrl" : "http://www.facebook.com/wimtv",
    "twitterContact" : "@wimtv",
    "linkedinUrl" : "http://www.linkedin.com/wimtv"
  }
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

profile

Profile

The user profile.

* Required.
* Must not be null.

finance

Finance

The user finance profile.

* Optional.

features

Features

The user features settings.

* Optional.

User profile

Path Type Description

firstName

String

First name.

* Required.
* Length must be between 0 and 64 inclusive.
* Must not be blank.

lastName

String

Last name.

* Required.
* Length must be between 0 and 64 inclusive.
* Must not be blank.

birthDate

Date

Birth date.

* Required.
* Must not be null.
* The birth date must be at least 18 years before today..

pageTitle

String

Page title.

* Optional.
* Length must be between 0 and 30 inclusive.

pageDescription

String

Page description.

* Optional.
* Length must be between 0 and 140 inclusive.

thumbnailId

String

Identifier of the thumbnail to assign to the user.

* Optional.
* Length must be between 0 and 36 inclusive.

email

String

E-mail.

* Required.
* Length must be between 0 and 128 inclusive.
* Must be a well-formed email address.
* Must not be blank.

facebookUrl

String

Facebook profile URL.

* Optional.
* Length must be between 0 and 255 inclusive.
* Must be a well-formed URL.

twitterContact

String

Twitter contact.

* Optional.
* Length must be between 0 and 128 inclusive.

linkedinUrl

String

LinkedIn profile URL.

* Optional.
* Length must be between 0 and 255 inclusive.
* Must be a well-formed URL.

User financial profile

Path Type Description

paypalEmail

String

PayPal account.

* Must be set if the user would deal financial transactions.
* Length must be between 0 and 128 inclusive.
* Must be a well-formed email address.

companyName

String

Company in the name of which the user would deal.

* Optional.
* Length must be between 0 and 80 inclusive.

companyConfirm

Boolean

Whether the user have the right to deal in the name of the specified company or not.

* Must be true if the user would deal in the name of the specified company.

taxCode

String

Tax code.

* Optional.
* Length must be between 0 and 16 inclusive.

vatNumber

String

VAT number.

* Optional.
* Length must be between 0 and 11 inclusive.

billingAddress

Address

Billing address.

* Optional.

User features settings

Path Type Description

trancoderNotifyEnabled

Boolean

Whether the user would like to receive notifications about the transcoding process.

vodPublic

Boolean

Whether the WimVod items should be visible in public pages. See Searches for WimVod items in public pages.

livePassword

String

The password for WimLive services.

* Must be set if the user would use WimLive services.
* Length must be between 0 and 32 inclusive.

Response

HTTP/1.1 200 OK
Content-Length: 887
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "livePassword" : "xXx",
    "vodPublic" : true
  },
  "userCode" : "john",
  "finance" : {
    "companyName" : "WimLabs",
    "billingAddress" : {
      "street" : "Piazza De Amicis 121 bis",
      "zipCode" : "10126",
      "city" : "Torino",
      "country" : "IT",
      "countryName" : "Italy",
      "state" : "Torino"
    },
    "vatNumber" : "10539730019",
    "paypalEmail" : "john@cedeo.net"
  },
  "profile" : {
    "thumbnailId" : "04cae6cd-55b7-40ee-92d6-75bc0549f00a",
    "firstName" : "John",
    "lastName" : "Doe",
    "birthDate" : "26/02/1972",
    "email" : "john@cedeo.net",
    "language" : "IT",
    "pageTitle" : "WimTV",
    "pageDescription" : "Test API",
    "facebookUrl" : "http://www.facebook.com/wimtv",
    "twitterContact" : "@wimtv",
    "linkedinUrl" : "http://www.linkedin.com/wimtv"
  }
}

Response fields

See Read the logged user.

Change password of the logged user

curl command

$ curl 'http://platform.wim.tv:8080/api/user/me/password/update' -i -X POST \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "passwordConfirm" : "secr4t",
  "newPassword" : "secr4t",
  "currentPassword" : "secr3t"
}'

Request fields

Path Type Description

currentPassword

String

The current password.

* Required.
* Must not be blank.

newPassword

String

The new password.

* Required.
* Must not be blank.

passwordConfirm

String

Must be set with the same password set in the newPassword field.

* Required.
* Must not be blank.

Response

HTTP/1.1 204 No Content

Request a new password for a user

curl command

$ curl 'http://platform.wim.tv:8080/api/public/user/password/renew' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "userCode" : "john",
  "confirmationUrl" : "http://platform.wim.tv/password/renew?token=${token}"
}'

Request fields

Path Type Description

userCode

String

The user code.

* Must be set only if the e-mail is not provided.
* Length must be between 4 and 50 inclusive.
* Must match the regular expression [a-zA-Z](\.[a-zA-Z][a-zA-Z0-9])*.

email

String

E-mail.

* Must be set only if the user code is not provided.
* Length must be between 0 and 128 inclusive.
* Must be a well-formed email address.

confirmationUrl

URI

Template URL to renew password page. The procedure replaces all occurrences of the variable ${token} with the authentication token.

* Required.
* Must not be blank.

Response

HTTP/1.1 200 OK
Content-Length: 820
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "livePassword" : "public",
    "vodPublic" : true
  },
  "userCode" : "john",
  "finance" : {
    "billingAddress" : {
      "street" : "Via Pier Carlo Boggio 59",
      "zipCode" : "10129",
      "city" : "Torino",
      "country" : "IT",
      "countryName" : "Italy",
      "state" : "Torino"
    },
    "vatNumber" : "13291920158",
    "paypalEmail" : "john@paypal.com"
  },
  "profile" : {
    "firstName" : "John",
    "lastName" : "Doe",
    "birthDate" : "26/02/1972",
    "email" : "john@cedeo.net",
    "language" : "EN",
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  }
}

Response fields

See Read the logged user.

Renew password of a user

curl command

$ curl 'http://platform.wim.tv:8080/api/public/user/password/renew?token=5d781d5a-6b4e-4669-b6a3-47f9bf96e480' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request parameters

Parameter Description

token

The renew password token.

Response

HTTP/1.1 200 OK
Content-Length: 820
Content-Type: application/json;charset=UTF-8

{
  "features" : {
    "transcoderNotifyEnabled" : false,
    "livePassword" : "public",
    "vodPublic" : true
  },
  "userCode" : "john",
  "finance" : {
    "billingAddress" : {
      "street" : "Via Pier Carlo Boggio 59",
      "zipCode" : "10129",
      "city" : "Torino",
      "country" : "IT",
      "countryName" : "Italy",
      "state" : "Torino"
    },
    "vatNumber" : "13291920158",
    "paypalEmail" : "john@paypal.com"
  },
  "profile" : {
    "firstName" : "John",
    "lastName" : "Doe",
    "birthDate" : "26/02/1972",
    "email" : "john@cedeo.net",
    "language" : "EN",
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  }
}

Response fields

See Read the logged user.

Read the logged user for showing in private pages

curl command

$ curl 'http://platform.wim.tv:8080/api/user/me/overview' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 615
Content-Type: application/json;charset=UTF-8

{
  "availableRenews" : 338,
  "renewDate" : [ 2022, 3, 29 ],
  "userCode" : "john",
  "billingAddress" : {
    "street" : "Via Pier Carlo Boggio 59",
    "zipCode" : "10129",
    "city" : "Torino",
    "country" : "IT",
    "countryName" : "Italy",
    "state" : "Torino"
  },
  "vatNumber" : "13291920158",
  "licenseName" : "Professional",
  "storage" : "0,00",
  "band" : "0,00",
  "bandPercent" : "0,00",
  "paypalEmail" : "john@paypal.com",
  "livePassword" : "public",
  "daysToExpiration" : 10162,
  "licenseExpired" : false,
  "daysFromActivation" : 4448,
  "storagePercent" : "0,00",
  "videosCount" : 0
}

Response fields

Path Type Description

userCode

String

The user code.

licenseName

String

Name of the subscribed license. May be not provided.

licenseExpired

Boolean

Whether the license is expired.

availableRenews

Number

The numbers of renews available.

renewDate

Array

The date the current subscription is renewed.

daysFromActivation

Number

Number of days since the license hasbeen activated. May be not provided.

daysToExpiration

Number

Number of days until the license expiration. May be not provided.

videosCount

Number

Number of videos that the user have uploaded.

storagePercent

Percentage

Used storage.

bandPercent

Percentage

Used band.

storage

Percentage

Used storage (Gb).

band

Percentage

Used band (Gb).

paypalEmail

String

PayPal account. May be not provided.

taxCode

String

Tax code. May be not provided.

vatNumber

String

VAT number. May be not provided.

billingAddress

Address

Billing address. May be not provided.

livePassword

String

The password for WimLive services. May be not provided.

thumbnailId

String

Identifier of the thumbnail assigned to the user. May be not provided.

Read a user for showing in his public pages

curl command

$ curl 'http://platform.wim.tv:8080/api/public/user/john/overview' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/user/{userCode}/overview

Parameter Description

userCode

The user code.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 265

{
  "userCode" : "john",
  "licenseExpired" : false,
  "pageTitle" : "WimLabs",
  "pageDescription" : "Video Communications",
  "facebookUrl" : "http://www.facebook.com/wimlabs",
  "twitterContact" : "@wimlabs",
  "linkedinUrl" : "http://www.linkedin.com/wimlabs"
}

Response fields

Path Type Description

userCode

String

The user code.

pageTitle

String

Page title. May be not provided.

pageDescription

String

Page description. May be not provided.

thumbnailId

String

The thumbnail identifier. May be not provided.

facebookUrl

String

Facebook profile URL. May be not provided.

twitterContact

String

Twitter contact. May be not provided.

linkedinUrl

String

LinkedIn profile URL. May be not provided.

licenseExpired

Boolean

Whether the licences is expired.

curl command

$ curl 'http://platform.wim.tv:8080/api/public/search/users' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

Query string

The query string applies on the following fields:

  • Username

  • First name

  • Last name

  • Page title

  • Page description

Response

HTTP/1.1 200 OK
Content-Length: 283
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "userCode" : "andrew",
    "licenseExpired" : false
  }, {
    "userCode" : "kotas",
    "licenseExpired" : false
  }, {
    "userCode" : "mariya",
    "licenseExpired" : false
  } ],
  "pageIndex" : 0,
  "totalCount" : 3,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

Path Type Description

userCode

String

The user code.

pageTitle

String

Page title. May be not provided.

pageDescription

String

Page description. May be not provided.

thumbnailId

String

The thumbnail identifier. May be not provided.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Last activity date

  3. Username

Licenses (aka commercial packets)

Pays to subscribe a license

This API acts as the payment API in a 2-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/license/Professional/subscribe' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/license/accepted",
  "cancelUrl" : "http://platform.wim.tv/license/rejected",
  "embedded" : false,
  "mobile" : false
}'

Path parameters

/api/license/{licenseName}/subscribe

Parameter Description

licenseName

The license name.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 402
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "73ed582d-9a0d-4c22-bc42-de666da42966",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "price" : "14,90",
    "storage" : 50,
    "band" : 80,
    "maxVideoSize" : 2,
    "maxUploadNumber" : 50,
    "name" : "Professional",
    "id" : 3,
    "support" : "PHONE",
    "dayDuration" : 30
  }
}

Response fields

See Gets the payment parameters.

Resource fields

Path Type Description

id

Number

License ID.

name

String

License name.

price

Amount

Price.

duration

Number

Duration (days).

storage

Number

Maximum storage (Gb).

band

Number

Maximum band (Gb).

streamingAmount

Number

Approximate amount of time of streaming available (hours).

support

Support

Support mode.

Activates a license checking for the succeeded payment

This API acts as the check payment API in a 2-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/license/Professional/activate' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "trackingId" : "73ed582d-9a0d-4c22-bc42-de666da42966"
}'

Path parameters

/api/license/{licenseName}/activate

Parameter Description

licenseName

The license name.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Checking whether a payment has succeeded or not.

Response

HTTP/1.1 200 OK
Content-Length: 615
Content-Type: application/json;charset=UTF-8

{
  "availableRenews" : 339,
  "renewDate" : [ 2022, 3, 29 ],
  "userCode" : "john",
  "billingAddress" : {
    "street" : "Via Pier Carlo Boggio 59",
    "zipCode" : "10129",
    "city" : "Torino",
    "country" : "IT",
    "countryName" : "Italy",
    "state" : "Torino"
  },
  "vatNumber" : "13291920158",
  "licenseName" : "Professional",
  "storage" : "0,00",
  "band" : "0,00",
  "bandPercent" : "0,00",
  "paypalEmail" : "john@paypal.com",
  "livePassword" : "public",
  "daysToExpiration" : 10192,
  "licenseExpired" : false,
  "daysFromActivation" : 4448,
  "storagePercent" : "0,00",
  "videosCount" : 0
}

Response fields

See Reads the logged user.

WimBox

Uploads a new content in WimBox

$ curl 'http://platform.wim.tv:8080/api/box' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'X-Wimtv-progressbarId: 0160879f-daec-4446-8069-d2ee69e6010b' \
    -F 'file=@sample.mp4' \
    -F 'contentIdentifier=urn:wim:tv:content:9cde6e52-163a-489e-87b0-1b709307bf44' \
    -F 'title=Title 1' \
    -F 'description=Description 1' \
    -F 'tag=tag1' \
    -F 'tag=tag2'

Request headers

Name Description

X-Wimtv-progressbarId

The progress bar identifier. You can query the progress bar value through by the /api/progressbar/{progressbarId} API.

* Optional.

Accept

application/json

* Required.

Request parts

Part Type Description

file

Local Path

Content to upload.

* Required.
* Must not be empty.

contentIdentifier

String

The custom content identifier (e.g. a client can hold his own identifiers related to the resources).
We recommend using identifiers in your own namespace (e.g. urn:my:domain:12345678).

* Optional.
* Length must be between 0 and 80 inclusive.
* Must match the regular expression (:[\w-_])*.

title

String

Title.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

thumbnailId

String

Identifier of the thumbnail to assign to the content.

* Optional.
* Length must be between 0 and 36 inclusive.

tag

String

A tag.

* Optional.
* Multiple.

Response

HTTP/1.1 201 Created
Content-Length: 368
Content-Type: application/json;charset=UTF-8

{
  "status" : "READY",
  "valueDate" : "07/03/2022",
  "vodCount" : 0,
  "source" : "UPLOAD",
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "boxId" : "eb6b82d1-aaef-4e08-add0-14bc4903bb58",
  "contentId" : "urn:wim:tv:content:9cde6e52-163a-489e-87b0-1b709307bf44",
  "resourceId" : "431e4002-3e84-43cf-af92-c1ba886c188a",
  "title" : "Title 1"
}

Response fields

See Reads a WimBox item.

Reads a WimBox item

$ curl 'http://platform.wim.tv:8080/api/box/eb6b82d1-aaef-4e08-add0-14bc4903bb58' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/box/{boxId}

Parameter Description

boxId

The WimBox item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 368
Content-Type: application/json;charset=UTF-8

{
  "status" : "READY",
  "valueDate" : "07/03/2022",
  "vodCount" : 0,
  "source" : "UPLOAD",
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "boxId" : "eb6b82d1-aaef-4e08-add0-14bc4903bb58",
  "contentId" : "urn:wim:tv:content:9cde6e52-163a-489e-87b0-1b709307bf44",
  "resourceId" : "431e4002-3e84-43cf-af92-c1ba886c188a",
  "title" : "Title 1"
}

Response fields

Path Type Description

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

source

Source

The content source.

valueDate

Date

The created date.

expirationDate

Date

The expiration date. May be not provided.

status

Status

Ingestion status.

vodCount

Number

How many instance of a content are published in WimVod.

marketplaceLicense

Object

License conditions. Provided only for contents acquired from Market Place.

Market Place license conditions

Path Type Description

licenseId

String

The license identifier.

marketplaceId

String

The Market Place item identifier.

issuerCode

String

The issuer code.

licenseType

License Type

License type.

ccType

CC License

Creative Commons License. Provided only if the license type is CREATIVE_COMMONS.

activationPrice

Amount

Activation price. Provided if the license type is SPOT_PRICE, but also PAY_PER_VIEW and REVENUE_SHARING licenses may include an activation price.

pricePerView

Amount

The price per view. Provided only if the license type is PAY_PER_VIEW.

earningPercentage

Percentage

Earning percentage. Provided only if the license type is REVENUE_SHARING.

duration

Number

Duration. Provided only if the license has an expiration.

durationUnit

Duration Unit

Duration unit. Provided only if the license has an expiration.

download

Boolean

Whether the acquirer can download the content.

Updates an existing content in WimBox

$ curl 'http://platform.wim.tv:8080/api/box/eb6b82d1-aaef-4e08-add0-14bc4903bb58' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "thumbnailId" : "9aa678b4-0704-433e-ae13-d42afe1aac96",
  "title" : "Title 1"
}'

Path parameters

/api/box/{boxId}

Parameter Description

boxId

The WimBox item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

title

String

Title.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

thumbnailId

String

Identifier of the thumbnail to assign to the content.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 200 OK
Content-Length: 425
Content-Type: application/json;charset=UTF-8

{
  "status" : "READY",
  "valueDate" : "07/03/2022",
  "vodCount" : 0,
  "source" : "UPLOAD",
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "boxId" : "eb6b82d1-aaef-4e08-add0-14bc4903bb58",
  "contentId" : "urn:wim:tv:content:9cde6e52-163a-489e-87b0-1b709307bf44",
  "resourceId" : "431e4002-3e84-43cf-af92-c1ba886c188a",
  "thumbnailId" : "9aa678b4-0704-433e-ae13-d42afe1aac96",
  "title" : "Title 1"
}

Response fields

See Reads a WimBox item.

Deletes an existing content from WimBox

$ curl 'http://platform.wim.tv:8080/api/box/eb6b82d1-aaef-4e08-add0-14bc4903bb58' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/box/{boxId}

Parameter Description

boxId

The WimBox item identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/box/contents' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

source

Source

The content source.

* Optional.

excludeBundleId

String

Identifier of the content bundle containing the items to exclude.

* Optional.
* Length must be between 0 and 36 inclusive.

marketplaceLicense

Object

License conditions.

* May be provided only if the sorce is MARKET_PLACE.

Query string

The query string applies on the following fields:

  • Title

  • Description

  • Tags

Response

HTTP/1.1 200 OK
Content-Length: 1071
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "status" : "READY",
    "valueDate" : "07/03/2022",
    "vodCount" : 0,
    "source" : "UPLOAD",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "9bf6a775-4734-44ae-a783-3fb10b74e8d4",
    "contentId" : "urn:wim:tv:content:12e20c5c-c38b-4b66-af2d-bde76a775f7b",
    "resourceId" : "fa3e8d6a-1bf9-4002-876a-22a1e0d638ec",
    "thumbnailId" : "fc226541-5f33-495a-bdef-280ec3e0f71d",
    "title" : "Title 3",
    "duration" : "9:55"
  }, {
    "status" : "READY",
    "valueDate" : "07/03/2022",
    "vodCount" : 0,
    "source" : "UPLOAD",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "c1d674f5-51d8-40ee-9465-393e8213b40d",
    "contentId" : "urn:wim:tv:content:8944273f-2f1d-4f01-917b-b1679638f39c",
    "resourceId" : "0a25a750-82f5-4040-b216-a49d2719ca65",
    "thumbnailId" : "141ac7de-501b-450b-a351-19f6c3e5f3ad",
    "title" : "Title 2",
    "duration" : "6:37"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a WimBox item.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Creation date (descending)

Plays a WimBox item

$ curl 'http://platform.wim.tv:8080/api/box/5e6e5468-8e42-4f06-b925-e8a75ec2df72/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/box/{boxId}/play

Parameter Description

boxId

The WimBox item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 2104
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "status" : "READY",
    "valueDate" : "07/03/2022",
    "vodCount" : 0,
    "source" : "UPLOAD",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "5e6e5468-8e42-4f06-b925-e8a75ec2df72",
    "contentId" : "urn:wim:tv:content:0f1c5599-d5d2-411f-86ad-4aa79d815f5e",
    "resourceId" : "1cd0600a-bd96-42fb-87f6-30d94c533a14",
    "thumbnailId" : "34f036f1-ef7f-4a46-a92d-102575779377",
    "title" : "Title 1",
    "duration" : "6:52"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=27dca4a8-41f2-432b-ba18-2a72caae2cc0&streamSessionId=453a418c-4b86-4c09-a989-5fe9b8c4cebe&code=john&expires=1646736778565&ctrl=7e4d5dc48afb1900761e6eec8cbbcac8c2d6df320be90db456359ce9cdfc2a14d413a02e472cb440dabeab90c69697d9df877be388f9ad6d258ec16ceff10c70",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-f2c01362-85e2-46f6-8cfb-c6c8b00e2631-tr.mp4/playlist.m3u8?token=27dca4a8-41f2-432b-ba18-2a72caae2cc0&streamSessionId=453a418c-4b86-4c09-a989-5fe9b8c4cebe&code=john&expires=1646736778565&ctrl=7e4d5dc48afb1900761e6eec8cbbcac8c2d6df320be90db456359ce9cdfc2a14d413a02e472cb440dabeab90c69697d9df877be388f9ad6d258ec16ceff10c70"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-f2c01362-85e2-46f6-8cfb-c6c8b00e2631-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=27dca4a8-41f2-432b-ba18-2a72caae2cc0&streamSessionId=453a418c-4b86-4c09-a989-5fe9b8c4cebe&code=john&expires=1646736778565&ctrl=7e4d5dc48afb1900761e6eec8cbbcac8c2d6df320be90db456359ce9cdfc2a14d413a02e472cb440dabeab90c69697d9df877be388f9ad6d258ec16ceff10c70",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-f2c01362-85e2-46f6-8cfb-c6c8b00e2631-tr.mp4?token=27dca4a8-41f2-432b-ba18-2a72caae2cc0&streamSessionId=453a418c-4b86-4c09-a989-5fe9b8c4cebe&code=john&expires=1646736778565&ctrl=7e4d5dc48afb1900761e6eec8cbbcac8c2d6df320be90db456359ce9cdfc2a14d413a02e472cb440dabeab90c69697d9df877be388f9ad6d258ec16ceff10c70"
}

Response fields

See Plays a free content.

Resource fields

See Reads a WimBox item.

Requests a token to authorize the downloading of a content

$ curl 'http://platform.wim.tv:8080/api/content/urn:wim:tv:content:9cde6e52-163a-489e-87b0-1b709307bf44/download' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/content/{contentId}/download

Parameter Description

contentId

The content identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 54
Content-Type: application/json;charset=UTF-8

{
  "token" : "cfd08086-de04-4559-8867-5f9b67f05c5d"
}

Response fields

Path Type Description

token

String

The authorization token. You should use the token with the API /download/content/{contentId}.

WimVod

Publishes a content in WimVod

$ curl 'http://platform.wim.tv:8080/api/box/3a433954-823e-4b6d-880f-f9b0c8868be4/vod' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "licenseType" : "FREE",
  "public" : false
}'

Path parameters

/api/box/{boxId}/vod

Parameter Description

boxId

The WimBox item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

licenseType

License Type

License type.

* Required.
* Must not be null.

ccType

CC License

Creative Commons license.

* Must be set only if the license type is CREATIVE_COMMONS.

pricePerView

Amount

Price per view.

* Must be set only if the license type is PAY_PER_VIEW.
* Must be at least 0 (inclusive=false).

bundleId

String

The content bundle identifier.

* Must be set only if the license type is BUNDLE.
* Length must be between 0 and 36 inclusive.

public

Boolean

Whether the WimVod item has to be visible in public pages or not. See Searches for WimVod items in public pages.

* Optional.

Response

HTTP/1.1 201 Created
Content-Length: 495
Content-Type: application/json;charset=UTF-8

{
  "licenseType" : "FREE",
  "valueDate" : "07/03/2022",
  "vodId" : "b47e9991-c846-4ab4-959e-47c59c636003",
  "public" : false,
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "3a433954-823e-4b6d-880f-f9b0c8868be4",
  "contentId" : "urn:wim:tv:content:feab97d2-67d6-4c8e-9df1-c84bc73b5907",
  "resourceId" : "5bd2bc21-1bd4-46ec-8bde-5af420458bad",
  "thumbnailId" : "1e8ee2ee-55d5-404c-a5ac-fe892d53e0ae",
  "title" : "Title 1",
  "duration" : "5:00"
}

Response fields

See Reads a WimVod item.

Reads a WimVod item in private pages

$ curl 'http://platform.wim.tv:8080/api/vod/b47e9991-c846-4ab4-959e-47c59c636003' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/vod/{vodId}

Parameter Description

vodId

The WimVod item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 495
Content-Type: application/json;charset=UTF-8

{
  "licenseType" : "FREE",
  "valueDate" : "07/03/2022",
  "vodId" : "b47e9991-c846-4ab4-959e-47c59c636003",
  "public" : false,
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "3a433954-823e-4b6d-880f-f9b0c8868be4",
  "contentId" : "urn:wim:tv:content:feab97d2-67d6-4c8e-9df1-c84bc73b5907",
  "resourceId" : "5bd2bc21-1bd4-46ec-8bde-5af420458bad",
  "thumbnailId" : "1e8ee2ee-55d5-404c-a5ac-fe892d53e0ae",
  "title" : "Title 1",
  "duration" : "5:00"
}

Response fields

Path Type Description

vodId

String

The WimVod item identifier.

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

licenseType

License Type

License type.

ccType

CC License

Creative Commons license. Provided only if the license type is CREATIVE_COMMONS.

pricePerView

Amount

Price per view. Provided only if the license type is PAY_PER_VIEW.

bundle

Content Bundle

Content bundle. Provided only if the license type is BUNDLE.

valueDate

Date

The created date.

expirationDate

Date

Expiration date. May be not provided.

public

Boolean

Whether the WimVod item is visible in public pages or not. See Searches for WimVod items in public pages.

Reads a WimVod item in public pages

$ curl 'http://platform.wim.tv:8080/api/public/vod/4aa160b4-db41-4290-8624-a177ec8b6f4f' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/vod/{vodId}

Parameter Description

vodId

The item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 779
Content-Type: application/json;charset=UTF-8

{
  "licenseType" : "PAY_PER_VIEW",
  "vodId" : "4aa160b4-db41-4290-8624-a177ec8b6f4f",
  "publisher" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  },
  "description" : "Description 3",
  "tags" : [ "tag30", "tag31", "tag32" ],
  "boxId" : "a0717eb7-873d-47c3-a672-125e8d7725fe",
  "contentId" : "urn:wim:tv:content:2fdc2ffa-43d0-4b5e-a36f-3550d56db302",
  "resourceId" : "bc96c5b0-882e-40f9-a4f9-3f7b9ff027ba",
  "thumbnailId" : "9eb0a640-ff34-4027-915f-442cd1c0be3e",
  "title" : "Title 3",
  "duration" : "6:47",
  "pricePerView" : "2,00"
}

Response fields

Path Type Description

vodId

String

The WimVod item identifier.

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

licenseType

License Type

License type.

ccType

CC License

Creative Commons license. Provided only if the license type is CREATIVE_COMMONS.

pricePerView

Amount

Price per view. Provided only if the license type is PAY_PER_VIEW.

bundle

Content Bundle

Content bundle. Provided only if the license type is BUNDLE.

publisher

User

The publisher.

Updates an existing WimVod item

$ curl 'http://platform.wim.tv:8080/api/vod/b47e9991-c846-4ab4-959e-47c59c636003' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "licenseType" : "CREATIVE_COMMONS",
  "ccType" : "BY_NC_SA",
  "public" : true
}'

Path parameters

/api/vod/{vodId}

Parameter Description

vodId

The WimVod item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Publishes a content in WimVod.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 531

{
  "licenseType" : "CREATIVE_COMMONS",
  "valueDate" : "07/03/2022",
  "vodId" : "b47e9991-c846-4ab4-959e-47c59c636003",
  "public" : true,
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "3a433954-823e-4b6d-880f-f9b0c8868be4",
  "contentId" : "urn:wim:tv:content:feab97d2-67d6-4c8e-9df1-c84bc73b5907",
  "resourceId" : "5bd2bc21-1bd4-46ec-8bde-5af420458bad",
  "thumbnailId" : "1e8ee2ee-55d5-404c-a5ac-fe892d53e0ae",
  "title" : "Title 1",
  "duration" : "5:00",
  "ccType" : "BY_NC_SA"
}

Response fields

See Reads a WimVod item.

Deletes an existing WimVod item

$ curl 'http://platform.wim.tv:8080/api/vod/b47e9991-c846-4ab4-959e-47c59c636003' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/vod/{vodId}

Parameter Description

vodId

The WimVod item identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/vod/contents' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

public

Boolean

Whether the contents have to be visible in public pages.

* Optional.

conditions

Object

Publishing conditions.

* Optional.

Query string

The query string applies on the following fields:

  • Content

    • Title

    • Description

    • Tags

  • Content bundle (boost: 0.7; if not provided as filter)

    • Name

    • Description

    • Tags

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2988

{
  "pageSize" : 20,
  "items" : [ {
    "licenseType" : "PAY_PER_VIEW",
    "valueDate" : "07/03/2022",
    "vodId" : "ebc7c7d6-4341-4f8c-9c32-05a1a8f283f7",
    "public" : true,
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "4817eebf-8a83-4295-a058-ac380d306d97",
    "contentId" : "urn:wim:tv:content:48364df3-0da6-4262-8208-862e182cde64",
    "resourceId" : "440aa626-90bd-455d-80b4-19a9c46c7f65",
    "thumbnailId" : "14ef0996-6259-41ef-9a08-62174291bac3",
    "title" : "Title 3",
    "duration" : "9:47",
    "pricePerView" : "2,00"
  }, {
    "licenseType" : "CREATIVE_COMMONS",
    "valueDate" : "07/03/2022",
    "vodId" : "04fa6c2c-d337-4020-82d0-6738279d6f4b",
    "public" : true,
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "1dad529c-f2fd-4a6e-be9a-70f06a1b760a",
    "contentId" : "urn:wim:tv:content:d0998527-f83b-406f-ba97-9bb06f7617cb",
    "resourceId" : "5cc0133b-357b-4f58-8ae1-e6d86d2c51cc",
    "thumbnailId" : "b481fc4b-fcc3-49a5-b37c-3f335d124a71",
    "title" : "Title 2",
    "duration" : "6:37",
    "ccType" : "BY_SA"
  }, {
    "licenseType" : "CONTENT_BUNDLE",
    "valueDate" : "07/03/2022",
    "vodId" : "9c77ec25-29e1-44b6-9638-850cd4cb5964",
    "public" : true,
    "bundle" : {
      "description" : "Description 2",
      "durationUnit" : "MONTHS",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "itemCount" : 2,
      "thumbnailId" : "ca5742d1-d26c-4b46-a5f1-bc8de082bebe",
      "price" : "2,00",
      "bundleId" : "ca2fd8a2-4d8f-4cf7-a6b7-d259b2873f8f",
      "duration" : 1,
      "name" : "Name 2"
    },
    "description" : "Description 7",
    "tags" : [ "tag70", "tag71", "tag72" ],
    "boxId" : "4a6f02c8-bc85-4248-af1d-254f20ab65e0",
    "contentId" : "urn:wim:tv:content:43f8c575-7b2d-4680-b000-4b50e73a89f7",
    "resourceId" : "052de9a0-8843-48bf-b018-bcce580f7e9b",
    "thumbnailId" : "6155207a-da34-478b-9da2-1a846d12f9fb",
    "title" : "Title 7",
    "duration" : "6:34"
  }, {
    "licenseType" : "CONTENT_BUNDLE",
    "valueDate" : "07/03/2022",
    "vodId" : "2951f8e7-10b0-4bb4-88e2-e6705e056e2b",
    "public" : true,
    "bundle" : {
      "description" : "Description 2",
      "durationUnit" : "MONTHS",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "itemCount" : 2,
      "thumbnailId" : "ca5742d1-d26c-4b46-a5f1-bc8de082bebe",
      "price" : "2,00",
      "bundleId" : "ca2fd8a2-4d8f-4cf7-a6b7-d259b2873f8f",
      "duration" : 1,
      "name" : "Name 2"
    },
    "description" : "Description 6",
    "tags" : [ "tag60", "tag61", "tag62" ],
    "boxId" : "086d9683-174c-4d46-a25d-5592be0172c9",
    "contentId" : "urn:wim:tv:content:241cf1ef-a1f2-4ba6-b0c6-0f629cea6293",
    "resourceId" : "59915fd2-cb10-47b2-8c2c-b44461a9cd91",
    "thumbnailId" : "a74b140f-314d-4e91-930d-abda46681c97",
    "title" : "Title 6",
    "duration" : "9:07"
  } ],
  "pageIndex" : 0,
  "totalCount" : 4,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a WimVod item.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Searches for WimVod items in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/vod/contents' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'
If the public field of a WimVod item is set to false, that content is excluded from the search.
If the vodPublic field of the features section of a user is set to false, all contents published by that user are excluded from the search.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

conditions

Object

Publishing conditions.

* Optional.

Query string

The query string applies on the following fields:

  • Content

    • Title

    • Description

    • Tags

  • Content bundle (boost: 0.7; if not provided as filter)

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.5; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Length: 4714
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "4aa160b4-db41-4290-8624-a177ec8b6f4f",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "a0717eb7-873d-47c3-a672-125e8d7725fe",
    "contentId" : "urn:wim:tv:content:2fdc2ffa-43d0-4b5e-a36f-3550d56db302",
    "resourceId" : "bc96c5b0-882e-40f9-a4f9-3f7b9ff027ba",
    "thumbnailId" : "9eb0a640-ff34-4027-915f-442cd1c0be3e",
    "title" : "Title 3",
    "duration" : "6:47",
    "pricePerView" : "2,00"
  }, {
    "licenseType" : "CREATIVE_COMMONS",
    "vodId" : "e646f002-fc67-4356-9021-3fd64af67b5c",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "4eae00bf-44f5-445c-8bd7-efc3cb961933",
    "contentId" : "urn:wim:tv:content:02d5a1ea-ebe5-473c-8c85-924ad7c6c79a",
    "resourceId" : "abf8f8dd-5b69-4d7f-98e1-e5caa592f94b",
    "thumbnailId" : "88d87e09-9cb2-4fa8-ad84-f104a5776550",
    "title" : "Title 2",
    "duration" : "9:06",
    "ccType" : "BY_SA"
  }, {
    "licenseType" : "CONTENT_BUNDLE",
    "vodId" : "f1f608f0-dfd6-4f64-ae4c-c1159b3c8702",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "bundle" : {
      "description" : "Description 2",
      "durationUnit" : "MONTHS",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "itemCount" : 2,
      "thumbnailId" : "0b127327-f4da-45c1-8eed-4d1101d6b8d3",
      "price" : "2,00",
      "bundleId" : "40e9faac-19c2-4f2d-955e-fbf6f02996b7",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "duration" : 1,
      "name" : "Name 2"
    },
    "description" : "Description 7",
    "tags" : [ "tag70", "tag71", "tag72" ],
    "boxId" : "819bc348-98ea-4db4-9320-eb5da341973c",
    "contentId" : "urn:wim:tv:content:5107df73-8bd0-481e-99d4-8c7e56c6cae0",
    "resourceId" : "42b4b2a9-d376-45e5-ade6-ed849f324e17",
    "thumbnailId" : "156b401e-f86d-40f7-853b-564ff89eef68",
    "title" : "Title 7",
    "duration" : "6:58"
  }, {
    "licenseType" : "CONTENT_BUNDLE",
    "vodId" : "2b51a91b-423f-4df9-878d-1e35b8a79565",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "bundle" : {
      "description" : "Description 2",
      "durationUnit" : "MONTHS",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "itemCount" : 2,
      "thumbnailId" : "0b127327-f4da-45c1-8eed-4d1101d6b8d3",
      "price" : "2,00",
      "bundleId" : "40e9faac-19c2-4f2d-955e-fbf6f02996b7",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "duration" : 1,
      "name" : "Name 2"
    },
    "description" : "Description 6",
    "tags" : [ "tag60", "tag61", "tag62" ],
    "boxId" : "bb754825-6156-457d-ad9a-037fa120d423",
    "contentId" : "urn:wim:tv:content:51f87bca-a98b-471b-8350-9b2cd966e107",
    "resourceId" : "17b8fa2d-329e-46b0-9b02-3d196fc9bb5e",
    "thumbnailId" : "31c14b9b-25e6-460a-96b4-16f211437c10",
    "title" : "Title 6",
    "duration" : "6:00"
  } ],
  "pageIndex" : 0,
  "totalCount" : 4,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a WimVod item.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Path Type Description

licenseType

License Type

License type.

* Must be provided if ccType or bundleId are provided.

ccType

CC License

Creative Commons license.

* May be provided only if the license type is CREATIVE_COMMONS.

bundleId

String

The content bundle identifier.

* May be provided only if the license type is CONTENT_BUNDLE.
* Length must be between 0 and 36 inclusive.

Plays a WimVod item

This API acts as the transaction API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/vod/8a86aa39-d647-43fe-880a-89912ad9370d/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Path parameters

/api/vod/{vodId}/play

Parameter Description

vodId

The WimVod item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

If the content is free, you should not provide none of the request fields, otherwise you must provide the parameters to check for the succeeded payment.

Response

HTTP/1.1 200 OK
Content-Length: 2402
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "licenseType" : "FREE",
    "vodId" : "8a86aa39-d647-43fe-880a-89912ad9370d",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "9d332df3-da02-4534-9884-49479f9ee5b4",
    "contentId" : "urn:wim:tv:content:7322a958-4922-4a3f-909d-82fa2e9f1ed1",
    "resourceId" : "05f7feea-24a8-4809-ab51-c6bd0ff37adc",
    "thumbnailId" : "d8554128-37ab-4208-b928-c5e152216875",
    "title" : "Title 1",
    "duration" : "8:34"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4/playlist.m3u8?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825"
}

Response fields

If the content is free or the payment has succeeded, the response includes the parameters to setup your player, otherwise the response notifies that you have to pay.

Resource fields

See Reads a WimVod item.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/vod/5fd47f33-c178-4d08-b960-11f3edf52e7e/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Pays to play a WimVod item

This API acts as the payment API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/vod/e199a7c4-e7fd-4b68-8e21-ad819ca90a6c/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/vod/play",
  "cancelUrl" : "http://platform.wim.tv/vod/rejected",
  "embedded" : false,
  "mobile" : false
}'

Path parameters

/api/vod/{vodId}/pay

Parameter Description

vodId

The WimVod item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 1015
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "2d0b3507-1023-445d-ad92-3c024eaa3549",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "e199a7c4-e7fd-4b68-8e21-ad819ca90a6c",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "249f39f8-f921-4c43-83cf-bff44cd70d05",
    "contentId" : "urn:wim:tv:content:fccee630-da12-4065-999a-0c28f60fcafa",
    "resourceId" : "a80a7094-e9a6-4a01-8203-8c811cedc0ea",
    "thumbnailId" : "b1e42b65-2464-4b45-8a71-353549596a12",
    "title" : "Title 3",
    "duration" : "8:48",
    "pricePerView" : "2,00"
  }
}

Response fields

See Gets the payment parameters.

Resource fields

See Reads a WimVod item.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/vod/238f7a9f-9f55-4ea4-964f-80b92e5877ac/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/vod/play",
  "cancelUrl" : "http://platform.wim.tv/vod/rejected",
  "embedded" : false,
  "mobile" : false
}'

Previews a WimVod item

You can offer a free preview of a content (15 seconds) to your public.

$ curl 'http://platform.wim.tv:8080/api/public/vod/238f7a9f-9f55-4ea4-964f-80b92e5877ac/preview' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/vod/{vodId}/preview

Parameter Description

vodId

The WimVod item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 2491
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "238f7a9f-9f55-4ea4-964f-80b92e5877ac",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "913db299-3187-4d39-823b-26538e5b094d",
    "contentId" : "urn:wim:tv:content:8b80c8b5-7eac-40e7-b3df-63bed7b2f59f",
    "resourceId" : "b2b2d0f8-0e04-4462-b22f-1117a46886e5",
    "thumbnailId" : "96c9ad86-687a-45a9-9600-f1611cc0a5d0",
    "title" : "Title 3",
    "duration" : "6:25",
    "pricePerView" : "2,00"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=fd005275-3211-4e99-8cf0-ff4e363f2c07&streamSessionId=9088e090-93c3-491b-90b8-9564b89ec22a&code=john&expires=1646736799899&type=preview&ctrl=4a3a59c63311efb9bb694127f0d810c42f5b7a76bfd61ee69daa91c8f58b3ab72bbeb0605174ec580de91e07c9e00c128c6347dab89131224902ff64fff8309f",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-f64f3ac1-e0d8-49da-85a2-c6e72bf0f25a-tr.mp4/playlist.m3u8?token=fd005275-3211-4e99-8cf0-ff4e363f2c07&streamSessionId=9088e090-93c3-491b-90b8-9564b89ec22a&code=john&expires=1646736799899&type=preview&ctrl=4a3a59c63311efb9bb694127f0d810c42f5b7a76bfd61ee69daa91c8f58b3ab72bbeb0605174ec580de91e07c9e00c128c6347dab89131224902ff64fff8309f"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-f64f3ac1-e0d8-49da-85a2-c6e72bf0f25a-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=fd005275-3211-4e99-8cf0-ff4e363f2c07&streamSessionId=9088e090-93c3-491b-90b8-9564b89ec22a&code=john&expires=1646736799899&type=preview&ctrl=4a3a59c63311efb9bb694127f0d810c42f5b7a76bfd61ee69daa91c8f58b3ab72bbeb0605174ec580de91e07c9e00c128c6347dab89131224902ff64fff8309f",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-f64f3ac1-e0d8-49da-85a2-c6e72bf0f25a-tr.mp4?token=fd005275-3211-4e99-8cf0-ff4e363f2c07&streamSessionId=9088e090-93c3-491b-90b8-9564b89ec22a&code=john&expires=1646736799899&type=preview&ctrl=4a3a59c63311efb9bb694127f0d810c42f5b7a76bfd61ee69daa91c8f58b3ab72bbeb0605174ec580de91e07c9e00c128c6347dab89131224902ff64fff8309f"
}

Response fields

See Plays a free content.

Resource fields

See Reads a WimVod item.

Content bundles

See also the WimBundle APIs.

Creates a new content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description 1",
  "durationUnit" : "MONTHS",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "6f44115e-dec6-4cb8-92ba-70118a3af888",
  "price" : "5,20",
  "duration" : 1,
  "name" : "Bundle 1"
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

name

String

Name.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

price

Amount

Price.

* Required.
* Must be at least 0 (inclusive=false).
* Must not be null.

duration

Number

Duration.

* Required.
* Must be at least 1.

durationUnit

Duration Unit

Duration unit.

* Required.
* Must not be null.

thumbnailId

String

Identifier of the thumbnail to assign to the content bundle.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 201 Created
Content-Length: 290
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "durationUnit" : "MONTHS",
  "tags" : [ "tag1", "tag2" ],
  "itemCount" : 0,
  "thumbnailId" : "6f44115e-dec6-4cb8-92ba-70118a3af888",
  "price" : "5,20",
  "bundleId" : "2ee33567-64dd-4dc5-bcc5-57cd70f4275c",
  "duration" : 1,
  "name" : "Bundle 1"
}

Response fields

See Reads a content bundle.

Reads a content bundle in private pages

$ curl 'http://platform.wim.tv:8080/api/contentbundle/2ee33567-64dd-4dc5-bcc5-57cd70f4275c' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/contentbundle/{bundleId}

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 290
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "durationUnit" : "MONTHS",
  "tags" : [ "tag1", "tag2" ],
  "itemCount" : 0,
  "thumbnailId" : "6f44115e-dec6-4cb8-92ba-70118a3af888",
  "price" : "5,20",
  "bundleId" : "2ee33567-64dd-4dc5-bcc5-57cd70f4275c",
  "duration" : 1,
  "name" : "Bundle 1"
}

Response fields

Path Type Description

bundleId

String

The content bundle identifier.

name

String

The name.

description

String

The description. May be not provided.

price

Amount

The price.

duration

Number

The duration.

durationUnit

Duration Unit

Duration unit.

itemCount

Number

How many items are included in the content bundle.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads a content bundle in public pages

$ curl 'http://platform.wim.tv:8080/api/public/contentbundle/54f1a333-f40d-4244-a361-04d51f34b35b' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/contentbundle/{bundleId}

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 598

{
  "description" : "Description 3",
  "durationUnit" : "MONTHS",
  "tags" : [ "tag30", "tag31", "tag32" ],
  "itemCount" : 2,
  "thumbnailId" : "2268fb70-dafd-4c68-a136-3185151f1360",
  "price" : "2,00",
  "bundleId" : "54f1a333-f40d-4244-a361-04d51f34b35b",
  "publisher" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  },
  "duration" : 1,
  "name" : "Name 3"
}

Response fields

Path Type Description

bundleId

String

The content bundle identifier.

name

String

The name.

description

String

The description. May be not provided.

price

Amount

The price.

duration

Number

The duration.

durationUnit

Duration Unit

Duration unit.

publisher

User

The publisher.

itemCount

Number

How many items are included in the content bundle.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle/2ee33567-64dd-4dc5-bcc5-57cd70f4275c' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "durationUnit" : "DAYS",
  "tags" : [ "tag3" ],
  "thumbnailId" : "6f44115e-dec6-4cb8-92ba-70118a3af888",
  "price" : "5,45",
  "duration" : 40,
  "name" : "Bundle 1"
}'

Path parameters

/api/contentbundle/{bundleId}

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Creates a new content bundle.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 288

{
  "description" : "Description modified",
  "durationUnit" : "DAYS",
  "tags" : [ "tag3" ],
  "itemCount" : 0,
  "thumbnailId" : "6f44115e-dec6-4cb8-92ba-70118a3af888",
  "price" : "5,45",
  "bundleId" : "2ee33567-64dd-4dc5-bcc5-57cd70f4275c",
  "duration" : 40,
  "name" : "Bundle 1"
}

Response fields

See Reads a content bundle.

Deletes an existing content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle/2ee33567-64dd-4dc5-bcc5-57cd70f4275c' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/contentbundle/{bundleId}

Parameter Description

bundleId

The content bundle identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/contentbundles' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

Query string

The query string applies on the following fields:

  • Name

  • Description

  • Tags

Response

HTTP/1.1 200 OK
Content-Length: 737
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Description 3",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "itemCount" : 0,
    "thumbnailId" : "4e278fe2-5e1f-4717-89f7-e618528fb24d",
    "price" : "2,00",
    "bundleId" : "95cc90eb-7d36-42ef-b49f-73db25da196d",
    "duration" : 1,
    "name" : "Name 3"
  }, {
    "description" : "Description 2",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "itemCount" : 0,
    "thumbnailId" : "6fb0c97f-bd43-4609-82c4-5bb2b609ae20",
    "price" : "2,00",
    "bundleId" : "c55a77b2-e6f0-485b-b092-7e2015966f0e",
    "duration" : 1,
    "name" : "Name 2"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a content bundle.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Searches for content bundles in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/contentbundles' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

Query string

The query string applies on the following fields:

  • Content bundle

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.7; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Length: 1371
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Description 3",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "itemCount" : 2,
    "thumbnailId" : "2268fb70-dafd-4c68-a136-3185151f1360",
    "price" : "2,00",
    "bundleId" : "54f1a333-f40d-4244-a361-04d51f34b35b",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "duration" : 1,
    "name" : "Name 3"
  }, {
    "description" : "Description 2",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "itemCount" : 2,
    "thumbnailId" : "ec9eaf2c-b39a-43b0-b968-9ef8633fe5ba",
    "price" : "2,00",
    "bundleId" : "fdae8f1f-793b-4361-ac7d-23d284cd6165",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "duration" : 1,
    "name" : "Name 2"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a content bundle.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Pays to subscribe a content bundle

This API acts as the payment API in a 2-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/contentbundle/9b27db59-dec0-40f9-bbb3-2d13cdded669/subscribe' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/contentbundle/accepted",
  "cancelUrl" : "http://platform.wim.tv/contentbundle/rejected",
  "embedded" : false,
  "mobile" : false
}'

Path parameters

/api/contentbundle/{bundleId}/subscribe

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 830
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "d0b04222-249b-44f1-bb20-79fc956a5c15",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "description" : "Description 1",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "itemCount" : 0,
    "thumbnailId" : "f32ddcaf-1201-435f-aa88-473eb330346f",
    "price" : "2,00",
    "bundleId" : "9b27db59-dec0-40f9-bbb3-2d13cdded669",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "duration" : 1,
    "name" : "Name 1"
  }
}

Response fields

See Gets the payment parameters.

Resource fields

See Reads a content bundle.

Activates a content bundle subscription checking for the succeeded payment

This API acts as the check payment API in a 2-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/contentbundle/9b27db59-dec0-40f9-bbb3-2d13cdded669/activate' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "trackingId" : "d0b04222-249b-44f1-bb20-79fc956a5c15"
}'

Path parameters

/api/contentbundle/{bundleId}/activate

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Checking whether a payment has succeeded or not.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 598

{
  "description" : "Description 1",
  "durationUnit" : "MONTHS",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "itemCount" : 0,
  "thumbnailId" : "f32ddcaf-1201-435f-aa88-473eb330346f",
  "price" : "2,00",
  "bundleId" : "9b27db59-dec0-40f9-bbb3-2d13cdded669",
  "publisher" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  },
  "duration" : 1,
  "name" : "Name 1"
}

Response fields

See Reads a content bundle.

$ curl 'http://platform.wim.tv:8080/api/search/contentbundle/subscriptions' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "expiredIncluded" : false,
  "pageSize" : 20,
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

bundleId

String

The content bundle identifier.

* Optional.
* Length must be between 0 and 36 inclusive.

expiredIncluded

Boolean

Whether the expired subscriptions should be included.

* Optional.

Query string

The query string applies on the following fields:

  • Content bundle

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.7)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Length: 924
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "valueDate" : "07/03/2022",
    "expirationDate" : "07/04/2022",
    "bundle" : {
      "description" : "Description 1",
      "durationUnit" : "MONTHS",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "itemCount" : 0,
      "thumbnailId" : "f32ddcaf-1201-435f-aa88-473eb330346f",
      "price" : "2,00",
      "bundleId" : "9b27db59-dec0-40f9-bbb3-2d13cdded669",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "duration" : 1,
      "name" : "Name 1"
    },
    "subscriptionId" : "25f1a740-3e59-44e4-a39f-043cd62ba6e2"
  } ],
  "pageIndex" : 0,
  "totalCount" : 1,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

Path Type Description

subscriptionId

String

Subscription identifier.

bundle

Object

The content bundle.

valueDate

Date

Subscription date.

expirationDate

Date

Subscription expiration.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Subscription date

  3. Subscription expiration

  4. Name

WimBundle

By using the common APIs for WimVod and Content bundles, a content bundle is just like a label with a price and an expiration that you can stick on a set of contents, that is no order is defined for the contents in the bundle.
By using the WimBundle APIs, a content bundle is an ordered list of contents, instead.

Reads content bundle in private pages

$ curl 'http://platform.wim.tv:8080/api/contentbundle/52832245-405a-40e6-a149-eff47dc507d5/items' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/contentbundle/{bundleId}/items

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1348

{
  "items" : [ {
    "itemCode" : "d9d312d8-4a06-4499-a6a9-23f154ae5587",
    "vodId" : "a4d3eca0-6344-4b30-9df1-349e391abee9",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "c7940260-2102-41cd-b31f-df0032cd1d36",
    "contentId" : "urn:wim:tv:content:7218f8ed-204a-4acd-b2db-750addaa69cf",
    "resourceId" : "3ff72462-b62d-4ee9-9ed0-eea675258ddf",
    "thumbnailId" : "82264665-9113-489b-b1f1-fbcba3bc673d",
    "title" : "Title 1",
    "duration" : "8:07"
  }, {
    "itemCode" : "a6925254-ec25-43b9-9a45-904be97c9d23",
    "vodId" : "21b84699-031d-4605-8441-78ca4553ba49",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "f95500fc-26de-41d3-aa8d-b4bfe8f1f64d",
    "contentId" : "urn:wim:tv:content:5e47408c-04b5-4710-98f6-960b2accb858",
    "resourceId" : "7026210d-cbee-4916-bef1-30da4592577e",
    "thumbnailId" : "7e53d201-3222-49ae-bfff-2f4bb5d8c083",
    "title" : "Title 2",
    "duration" : "8:42"
  } ],
  "bundle" : {
    "description" : "Description 1",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "itemCount" : 2,
    "thumbnailId" : "ecef39aa-a70e-4fcd-9baa-ae64a52b968a",
    "price" : "2,00",
    "bundleId" : "52832245-405a-40e6-a149-eff47dc507d5",
    "duration" : 1,
    "name" : "Name 1"
  }
}

Response fields

Path Type Description

bundle

Content Bundle

Content bundle.

items

Array

The items.

Item fields

Path Type Description

itemCode

String

The content bundle item identifier.

vodId

String

The WimVod item identifier.

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads content bundle in public pages

$ curl 'http://platform.wim.tv:8080/api/public/contentbundle/54f1a333-f40d-4244-a361-04d51f34b35b/items' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/contentbundle/{bundleId}/items

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 1665
Content-Type: application/json;charset=UTF-8

{
  "items" : [ {
    "itemCode" : "cc354b88-db49-4fb9-9157-bb406c8048a4",
    "vodId" : "32571174-c15e-43e7-b255-5f26de174df9",
    "description" : "Description 5",
    "tags" : [ "tag50", "tag51", "tag52" ],
    "boxId" : "9bebb9a4-be4f-4cff-8bcd-28a7357fc3a4",
    "contentId" : "urn:wim:tv:content:b40a35ac-7f30-4ba6-8f89-3b29501f6142",
    "resourceId" : "c706fe96-20c2-4c92-8c3f-d8b9647a6cff",
    "thumbnailId" : "f9b7f513-07a6-446b-971c-367469fcde0b",
    "title" : "Title 5",
    "duration" : "8:18"
  }, {
    "itemCode" : "06965b7f-8cf3-418c-a003-979e5ba2f859",
    "vodId" : "26c007c7-cc0a-47e3-a465-50a4440b7a0c",
    "description" : "Description 6",
    "tags" : [ "tag60", "tag61", "tag62" ],
    "boxId" : "a7156e39-d362-4929-af26-07889f3bb926",
    "contentId" : "urn:wim:tv:content:663cf8d4-f50c-45c4-b395-7db5205b5895",
    "resourceId" : "ab8df3e1-6ca0-4d21-ab25-c7f8401d99da",
    "thumbnailId" : "cff7d891-22f7-4fd5-83e1-89b58aeb8a97",
    "title" : "Title 6",
    "duration" : "6:32"
  } ],
  "bundle" : {
    "description" : "Description 3",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "itemCount" : 2,
    "thumbnailId" : "2268fb70-dafd-4c68-a136-3185151f1360",
    "price" : "2,00",
    "bundleId" : "54f1a333-f40d-4244-a361-04d51f34b35b",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "duration" : 1,
    "name" : "Name 3"
  }
}

Response fields

Path Type Description

bundle

Content Bundle

Content bundle.

items

Array

The items.

Inserts one or more contents in a content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle/52832245-405a-40e6-a149-eff47dc507d5/items/insert' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "sourceItems" : [ {
    "boxId" : "6e4ad597-04e0-4edc-9cc2-6ef097221f1c"
  }, {
    "boxId" : "d07e4b0b-4020-4a22-9242-702eb876a5b8"
  } ],
  "index" : 1
}'

Path parameters

/api/contentbundle/{bundleId}/items/insert

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Insertion index.

* Required.
* Must be at least 0.

sourceItems

Array

Contents to insert.

* Required.
* Must not be null.

Content source

Path Type Description

boxId

String

The WimBox item identifier.

* Required.
* Length must be between 0 and 36 inclusive.
* Must not be blank.

Response

HTTP/1.1 200 OK
Content-Length: 2344
Content-Type: application/json;charset=UTF-8

{
  "items" : [ {
    "itemCode" : "d9d312d8-4a06-4499-a6a9-23f154ae5587",
    "vodId" : "a4d3eca0-6344-4b30-9df1-349e391abee9",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "c7940260-2102-41cd-b31f-df0032cd1d36",
    "contentId" : "urn:wim:tv:content:7218f8ed-204a-4acd-b2db-750addaa69cf",
    "resourceId" : "3ff72462-b62d-4ee9-9ed0-eea675258ddf",
    "thumbnailId" : "82264665-9113-489b-b1f1-fbcba3bc673d",
    "title" : "Title 1",
    "duration" : "8:07"
  }, {
    "itemCode" : "da467434-5331-470f-9b47-1ff3c7e18498",
    "vodId" : "e87afcf0-2ba9-452f-b641-47f1912f62a1",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "6e4ad597-04e0-4edc-9cc2-6ef097221f1c",
    "contentId" : "urn:wim:tv:content:6efa6bcf-1e62-4e13-923c-f41c5e6adc2c",
    "resourceId" : "14dce47e-195e-48fa-9d70-ae5a1d0d66de",
    "thumbnailId" : "056cf11d-30f3-4067-9c4b-1ddb5a8a9d40",
    "title" : "Title 3",
    "duration" : "8:04"
  }, {
    "itemCode" : "0266db8a-4715-4b3f-8d1f-7076c9c4f8eb",
    "vodId" : "0ecf1254-e827-441c-b8ce-da4c81e515d0",
    "description" : "Description 4",
    "tags" : [ "tag40", "tag41", "tag42" ],
    "boxId" : "d07e4b0b-4020-4a22-9242-702eb876a5b8",
    "contentId" : "urn:wim:tv:content:20d9ec45-f56f-4725-b973-2ef5e7d2d494",
    "resourceId" : "eeb4ca0d-7166-4fad-8130-74fb584bdc94",
    "thumbnailId" : "d005cdae-8a51-495d-b6ec-6dc89c7613f2",
    "title" : "Title 4",
    "duration" : "7:20"
  }, {
    "itemCode" : "a6925254-ec25-43b9-9a45-904be97c9d23",
    "vodId" : "21b84699-031d-4605-8441-78ca4553ba49",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "f95500fc-26de-41d3-aa8d-b4bfe8f1f64d",
    "contentId" : "urn:wim:tv:content:5e47408c-04b5-4710-98f6-960b2accb858",
    "resourceId" : "7026210d-cbee-4916-bef1-30da4592577e",
    "thumbnailId" : "7e53d201-3222-49ae-bfff-2f4bb5d8c083",
    "title" : "Title 2",
    "duration" : "8:42"
  } ],
  "bundle" : {
    "description" : "Description 1",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "itemCount" : 4,
    "thumbnailId" : "ecef39aa-a70e-4fcd-9baa-ae64a52b968a",
    "price" : "2,00",
    "bundleId" : "52832245-405a-40e6-a149-eff47dc507d5",
    "duration" : 1,
    "name" : "Name 1"
  }
}

Response fields

See Reads a content bundle.

Moves a content in a content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle/52832245-405a-40e6-a149-eff47dc507d5/items/move' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "fromIndex" : 1,
  "toIndex" : 3
}'

Path parameters

/api/contentbundle/{bundleId}/items/move

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

fromIndex

Number

Index of the content to move.

* Required.
* Must be at least 0.

toIndex

Number

Index of the content before of which insert the moved content.

* Required.
* Must be at least 0.

Response

HTTP/1.1 200 OK
Content-Length: 2344
Content-Type: application/json;charset=UTF-8

{
  "items" : [ {
    "itemCode" : "d9d312d8-4a06-4499-a6a9-23f154ae5587",
    "vodId" : "a4d3eca0-6344-4b30-9df1-349e391abee9",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "c7940260-2102-41cd-b31f-df0032cd1d36",
    "contentId" : "urn:wim:tv:content:7218f8ed-204a-4acd-b2db-750addaa69cf",
    "resourceId" : "3ff72462-b62d-4ee9-9ed0-eea675258ddf",
    "thumbnailId" : "82264665-9113-489b-b1f1-fbcba3bc673d",
    "title" : "Title 1",
    "duration" : "8:07"
  }, {
    "itemCode" : "0266db8a-4715-4b3f-8d1f-7076c9c4f8eb",
    "vodId" : "0ecf1254-e827-441c-b8ce-da4c81e515d0",
    "description" : "Description 4",
    "tags" : [ "tag40", "tag41", "tag42" ],
    "boxId" : "d07e4b0b-4020-4a22-9242-702eb876a5b8",
    "contentId" : "urn:wim:tv:content:20d9ec45-f56f-4725-b973-2ef5e7d2d494",
    "resourceId" : "eeb4ca0d-7166-4fad-8130-74fb584bdc94",
    "thumbnailId" : "d005cdae-8a51-495d-b6ec-6dc89c7613f2",
    "title" : "Title 4",
    "duration" : "7:20"
  }, {
    "itemCode" : "da467434-5331-470f-9b47-1ff3c7e18498",
    "vodId" : "e87afcf0-2ba9-452f-b641-47f1912f62a1",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "6e4ad597-04e0-4edc-9cc2-6ef097221f1c",
    "contentId" : "urn:wim:tv:content:6efa6bcf-1e62-4e13-923c-f41c5e6adc2c",
    "resourceId" : "14dce47e-195e-48fa-9d70-ae5a1d0d66de",
    "thumbnailId" : "056cf11d-30f3-4067-9c4b-1ddb5a8a9d40",
    "title" : "Title 3",
    "duration" : "8:04"
  }, {
    "itemCode" : "a6925254-ec25-43b9-9a45-904be97c9d23",
    "vodId" : "21b84699-031d-4605-8441-78ca4553ba49",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "f95500fc-26de-41d3-aa8d-b4bfe8f1f64d",
    "contentId" : "urn:wim:tv:content:5e47408c-04b5-4710-98f6-960b2accb858",
    "resourceId" : "7026210d-cbee-4916-bef1-30da4592577e",
    "thumbnailId" : "7e53d201-3222-49ae-bfff-2f4bb5d8c083",
    "title" : "Title 2",
    "duration" : "8:42"
  } ],
  "bundle" : {
    "description" : "Description 1",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "itemCount" : 4,
    "thumbnailId" : "ecef39aa-a70e-4fcd-9baa-ae64a52b968a",
    "price" : "2,00",
    "bundleId" : "52832245-405a-40e6-a149-eff47dc507d5",
    "duration" : 1,
    "name" : "Name 1"
  }
}

Response fields

See Reads a content bundle.

Removes one or more contents from a content bundle

$ curl 'http://platform.wim.tv:8080/api/contentbundle/52832245-405a-40e6-a149-eff47dc507d5/items/remove' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "count" : 2,
  "index" : 1
}'

Path parameters

/api/contentbundle/{bundleId}/items/remove

Parameter Description

bundleId

The content bundle identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Index of the first content to remove.

* Required.
* Must be at least 0.

count

Number

Number of contents to remove.

* Required.
* Must be at least 1.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1348

{
  "items" : [ {
    "itemCode" : "d9d312d8-4a06-4499-a6a9-23f154ae5587",
    "vodId" : "a4d3eca0-6344-4b30-9df1-349e391abee9",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "c7940260-2102-41cd-b31f-df0032cd1d36",
    "contentId" : "urn:wim:tv:content:7218f8ed-204a-4acd-b2db-750addaa69cf",
    "resourceId" : "3ff72462-b62d-4ee9-9ed0-eea675258ddf",
    "thumbnailId" : "82264665-9113-489b-b1f1-fbcba3bc673d",
    "title" : "Title 1",
    "duration" : "8:07"
  }, {
    "itemCode" : "a6925254-ec25-43b9-9a45-904be97c9d23",
    "vodId" : "21b84699-031d-4605-8441-78ca4553ba49",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "f95500fc-26de-41d3-aa8d-b4bfe8f1f64d",
    "contentId" : "urn:wim:tv:content:5e47408c-04b5-4710-98f6-960b2accb858",
    "resourceId" : "7026210d-cbee-4916-bef1-30da4592577e",
    "thumbnailId" : "7e53d201-3222-49ae-bfff-2f4bb5d8c083",
    "title" : "Title 2",
    "duration" : "8:42"
  } ],
  "bundle" : {
    "description" : "Description 1",
    "durationUnit" : "MONTHS",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "itemCount" : 2,
    "thumbnailId" : "ecef39aa-a70e-4fcd-9baa-ae64a52b968a",
    "price" : "2,00",
    "bundleId" : "52832245-405a-40e6-a149-eff47dc507d5",
    "duration" : 1,
    "name" : "Name 1"
  }
}

Response fields

See Reads a content bundle.

Market Place

Publishes a content in Market Place

$ curl 'http://platform.wim.tv:8080/api/box/831b7f1c-85a6-45f2-bcc8-c608164b0289/marketplace' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "licenseType" : "FREE",
  "download" : true
}'

Path parameters

/api/box/{boxId}/marketplace

Parameter Description

boxId

The WimBox item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

licenseType

License Type

License type.

* Required.
* Must not be null.

ccType

CC License

Creative Commons license.

* Must be set only if the license type is CREATIVE_COMMONS.

activationPrice

Amount

Activation price.

* Must be set if the license type is SPOT_PRICE, but may be set also if the license type is PAY_PER_VIEW or REVENUE_SHARING.
* Must be at least 0 (inclusive=false).

pricePerView

Amount

Price per view.

* Must be set only if the license type is PAY_PER_VIEW.
* Must be at least 0 (inclusive=false).

earningPercentage

Percentage

Earning percentage.

* Must be set only if the license type is REVENUE_SHARING.
* Must be at least 0 (inclusive=false).
* Must be at most 100.

duration

Number

Duration.

* May be set only if the license type is not CREATIVE_COMMONS.
* Must be at least 1.

durationUnit

Duration Unit

Duration unit.

* May be set only if the license type is not CREATIVE_COMMONS.

download

Boolean

Whether the acquirer can download the content.

* May be true only if the license type is not CREATIVE_COMMONS.

Response

HTTP/1.1 201 Created
Content-Length: 501
Content-Type: application/json;charset=UTF-8

{
  "conditions" : {
    "licenseType" : "FREE",
    "download" : true
  },
  "marketplaceId" : "f96df348-8892-4329-a4a8-0f3498b3d41f",
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "831b7f1c-85a6-45f2-bcc8-c608164b0289",
  "contentId" : "urn:wim:tv:content:aa3cc30e-3162-43cf-bc64-c885284a90b1",
  "resourceId" : "37b70502-ed48-45a5-8611-71d95f9f6bec",
  "thumbnailId" : "d3232fb3-11bf-40c0-bd19-33386de1b88f",
  "title" : "Title 1",
  "duration" : "5:25"
}

Response fields

See Reads a Market Place item.

Reads a Market Place item

$ curl 'http://platform.wim.tv:8080/api/marketplace/f96df348-8892-4329-a4a8-0f3498b3d41f' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/marketplace/{marketplaceId}

Parameter Description

marketplaceId

The Market Place item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 501
Content-Type: application/json;charset=UTF-8

{
  "conditions" : {
    "licenseType" : "FREE",
    "download" : true
  },
  "marketplaceId" : "f96df348-8892-4329-a4a8-0f3498b3d41f",
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "831b7f1c-85a6-45f2-bcc8-c608164b0289",
  "contentId" : "urn:wim:tv:content:aa3cc30e-3162-43cf-bc64-c885284a90b1",
  "resourceId" : "37b70502-ed48-45a5-8611-71d95f9f6bec",
  "thumbnailId" : "d3232fb3-11bf-40c0-bd19-33386de1b88f",
  "title" : "Title 1",
  "duration" : "5:25"
}

Response fields

Path Type Description

marketplaceId

String

The Market Place item identifier.

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

conditions

Object

License conditions.

Reads a Market Place item in public pages

$ curl 'http://platform.wim.tv:8080/api/public/marketplace/cd13ba72-4efa-4588-a50d-3de08db9e574' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/marketplace/{marketplaceId}

Parameter Description

marketplaceId

The item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 836
Content-Type: application/json;charset=UTF-8

{
  "conditions" : {
    "licenseType" : "SPOT_PRICE",
    "activationPrice" : "0,50",
    "download" : false
  },
  "marketplaceId" : "cd13ba72-4efa-4588-a50d-3de08db9e574",
  "description" : "Description 3",
  "tags" : [ "tag30", "tag31", "tag32" ],
  "boxId" : "59d0d200-5fe5-4a0d-a41e-6432cbca37b0",
  "contentId" : "urn:wim:tv:content:a6f85718-89be-4698-af49-35e863c92187",
  "resourceId" : "df02a872-22d9-4b5e-8010-b643398bff69",
  "thumbnailId" : "dcc7e663-c805-4860-83d5-5cc7ce332486",
  "title" : "Title 3",
  "duration" : "5:43",
  "seller" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  }
}

Response fields

Path Type Description

marketplaceId

String

The Market Place item identifier.

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

seller

User

The issuer.

conditions

Object

License conditions.

License conditions

Path Type Description

licenseType

License Type

License type.

ccType

CC License

Creative Commons License. Provided only if the license type is CREATIVE_COMMONS.

activationPrice

Amount

Activation price. Provided if the license type is SPOT_PRICE, but also PAY_PER_VIEW and REVENUE_SHARING licenses may include an activation price.

pricePerView

Amount

The price per view. Provided only if the license type is PAY_PER_VIEW.

earningPercentage

Percentage

Earning percentage. Provided only if the license type is REVENUE_SHARING.

duration

Number

Duration. Provided only if the license has an expiration.

durationUnit

Duration Unit

Duration unit. Provided only if the license has an expiration.

download

Boolean

Whether the acquirer can download the content.

Updates an existing Market Place item

$ curl 'http://platform.wim.tv:8080/api/marketplace/f96df348-8892-4329-a4a8-0f3498b3d41f' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "licenseType" : "CREATIVE_COMMONS",
  "ccType" : "BY_NC_SA",
  "download" : false
}'

Path parameters

/api/marketplace/{marketplaceId}

Parameter Description

marketplaceId

The Market Place item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Publishes a content in Market Place.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 541

{
  "conditions" : {
    "licenseType" : "CREATIVE_COMMONS",
    "ccType" : "BY_NC_SA",
    "download" : false
  },
  "marketplaceId" : "f96df348-8892-4329-a4a8-0f3498b3d41f",
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "boxId" : "831b7f1c-85a6-45f2-bcc8-c608164b0289",
  "contentId" : "urn:wim:tv:content:aa3cc30e-3162-43cf-bc64-c885284a90b1",
  "resourceId" : "37b70502-ed48-45a5-8611-71d95f9f6bec",
  "thumbnailId" : "d3232fb3-11bf-40c0-bd19-33386de1b88f",
  "title" : "Title 1",
  "duration" : "5:25"
}

Response fields

See Reads a Market Place item.

Deletes an existing Market Place item

$ curl 'http://platform.wim.tv:8080/api/marketplace/f96df348-8892-4329-a4a8-0f3498b3d41f' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/marketplace/{marketplaceId}

Parameter Description

marketplaceId

The Market Place item identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/marketplace/contents' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

conditions

Object

License conditions.

* Optional.

Query string

The query string applies on the following fields:

  • Content

    • Title

    • Description

    • Tags

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1237

{
  "pageSize" : 20,
  "items" : [ {
    "conditions" : {
      "licenseType" : "SPOT_PRICE",
      "activationPrice" : "0,50",
      "download" : false
    },
    "marketplaceId" : "97c820b3-1930-4faa-91ab-268506be50ba",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "26aeeab1-7ba9-4b21-b469-a420e9daea45",
    "contentId" : "urn:wim:tv:content:49398b9d-e7cf-4ef1-a316-9d51cc0acd41",
    "resourceId" : "5aa0c9d4-1620-4009-9bfb-6c74d95ddcbb",
    "thumbnailId" : "09ca1201-8013-4cc2-bc03-937a1fbb069b",
    "title" : "Title 3",
    "duration" : "5:35"
  }, {
    "conditions" : {
      "licenseType" : "CREATIVE_COMMONS",
      "ccType" : "BY_SA",
      "download" : false
    },
    "marketplaceId" : "7f1f2932-f817-47ad-852b-d6e70170853a",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "dba2dc90-1feb-4aad-bc31-1deb29ffdaac",
    "contentId" : "urn:wim:tv:content:3f3de297-87dd-4f80-b9ea-cf451580c519",
    "resourceId" : "03f1dd51-4546-474e-a859-afce849a584a",
    "thumbnailId" : "7f384809-8ffa-49a1-a27b-5baa38fe430c",
    "title" : "Title 2",
    "duration" : "6:23"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a Market Place item.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Searches for Market Place items in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/marketplace/contents' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "tag21 tag32",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

conditions

Object

License conditions.

* Optional.

excludeUserCode

String

Code of the user that has published the contents to exclude.

* Optional.
* Length must be between 0 and 50 inclusive.

Query string

The query string applies on the following fields:

  • Content

    • Title

    • Description

    • Tags

  • Seller (boost: 0.7; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1865

{
  "pageSize" : 20,
  "items" : [ {
    "conditions" : {
      "licenseType" : "SPOT_PRICE",
      "activationPrice" : "0,50",
      "download" : false
    },
    "marketplaceId" : "cd13ba72-4efa-4588-a50d-3de08db9e574",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "59d0d200-5fe5-4a0d-a41e-6432cbca37b0",
    "contentId" : "urn:wim:tv:content:a6f85718-89be-4698-af49-35e863c92187",
    "resourceId" : "df02a872-22d9-4b5e-8010-b643398bff69",
    "thumbnailId" : "dcc7e663-c805-4860-83d5-5cc7ce332486",
    "title" : "Title 3",
    "duration" : "5:43",
    "seller" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    }
  }, {
    "conditions" : {
      "licenseType" : "CREATIVE_COMMONS",
      "ccType" : "BY_SA",
      "download" : false
    },
    "marketplaceId" : "28a7f88c-d9d4-4bd6-bb56-1cfefd49d2f3",
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "boxId" : "e150750b-30a7-43f2-a808-e7708a2ecb08",
    "contentId" : "urn:wim:tv:content:0a6d16cd-1a7c-408f-95b4-68b209fdca3b",
    "resourceId" : "e6e17fc7-227d-43dd-b18e-bc20e70cc273",
    "thumbnailId" : "8e70d563-1f07-4cd7-95d3-87bdd21671f7",
    "title" : "Title 2",
    "duration" : "5:27",
    "seller" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    }
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a Market Place item.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Publishing date (descending)

Path Type Description

licenseType

License Type

License type.

* Must be provided if ccType is provided.

ccType

CC License

Creative Commons license.

* May be provided only if the license type is CREATIVE_COMMONS.

download

Boolean

Whether the buyer can download the contents.

* Optional.

Acquires a Market Place item

This API acts as the transaction API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/marketplace/e69cba64-4128-4741-8179-02776f39bf05/acquire' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Path parameters

/api/marketplace/{marketplaceId}/acquire

Parameter Description

marketplaceId

The Market Place item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

If the content is free, you should not provide none of the request fields, otherwise you must provide the parameters to check for the succeeded payment.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1579

{
  "boxContent" : {
    "marketplaceLicense" : {
      "licenseId" : "6f4fd832-51a2-471b-98aa-5570f68ea905",
      "marketplaceId" : "e69cba64-4128-4741-8179-02776f39bf05",
      "issuerCode" : "john",
      "licenseType" : "FREE",
      "download" : false
    },
    "valueDate" : "07/03/2022",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "a77cf420-4b48-41b1-9cfb-2e707482708f",
    "contentId" : "urn:wim:tv:content:02da3a56-0aae-4d99-ade8-88a936d0fe58",
    "resourceId" : "57d63dd3-0e81-4eac-993d-b42248b3b1b8",
    "thumbnailId" : "5ccd4930-4582-443a-9a97-3507823897a9",
    "title" : "Title 1",
    "duration" : "5:35"
  },
  "marketplaceContent" : {
    "conditions" : {
      "licenseType" : "FREE",
      "download" : false
    },
    "marketplaceId" : "e69cba64-4128-4741-8179-02776f39bf05",
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "393510e8-e25d-47d7-ad13-55dad45b0f68",
    "contentId" : "urn:wim:tv:content:02da3a56-0aae-4d99-ade8-88a936d0fe58",
    "resourceId" : "57d63dd3-0e81-4eac-993d-b42248b3b1b8",
    "thumbnailId" : "5ccd4930-4582-443a-9a97-3507823897a9",
    "title" : "Title 1",
    "duration" : "5:35",
    "seller" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    }
  },
  "result" : "FULFILLED"
}

Response fields

Path Type Description

result

Result

Result of the request.

marketplaceContent

Object

The Market Place item.

boxContent

Object

The acquired WimBox item. Provided only if the result is FULFILLED.

Pays to acquire a Market Place item

This API acts as the payment API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/marketplace/73c2ad8e-d199-4571-b84c-04b7212ac284/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/marketplace/acquire",
  "cancelUrl" : "http://platform.wim.tv/marketplace/rejected",
  "embedded" : false,
  "mobile" : false
}'

Path parameters

/api/marketplace/{marketplaceId}/pay

Parameter Description

marketplaceId

The Market Place item identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 1078
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "2475f565-2f1f-4af0-83c4-62498e62e473",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "conditions" : {
      "licenseType" : "SPOT_PRICE",
      "activationPrice" : "0,50",
      "download" : false
    },
    "marketplaceId" : "73c2ad8e-d199-4571-b84c-04b7212ac284",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "fbc2c81b-ebf5-4ff9-852c-551fdd6480ce",
    "contentId" : "urn:wim:tv:content:903c612f-dcbe-4502-88de-bf26f77ccf6e",
    "resourceId" : "e38416d0-c0cb-45ab-b235-d7ca15a720b8",
    "thumbnailId" : "328007ad-00e0-41ca-9463-9b87a5c7705b",
    "title" : "Title 3",
    "duration" : "5:05",
    "seller" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    }
  }
}

Response fields

See Gets the payment parameters.

Resource fields

See Reads a Market Place item.

Previews a Market Place item

You can offer a free preview of a content (15 seconds) to your customers.

$ curl 'http://platform.wim.tv:8080/api/public/marketplace/fe2452bc-d7d4-42b8-b898-ed8b850b63bf/preview' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/marketplace/{marketplaceId}/preview

Parameter Description

marketplaceId

The Market Place item identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 2554
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "conditions" : {
      "licenseType" : "SPOT_PRICE",
      "activationPrice" : "0,50",
      "download" : false
    },
    "marketplaceId" : "fe2452bc-d7d4-42b8-b898-ed8b850b63bf",
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "91df31c4-6e34-4a5a-81b2-022178ac6c8c",
    "contentId" : "urn:wim:tv:content:8c7eaac1-7284-45c1-b469-95cd28352863",
    "resourceId" : "daec4b05-5969-430b-9d83-ba5245afb1a1",
    "thumbnailId" : "d2504907-1f15-436e-8d9e-394aa55f6b81",
    "title" : "Title 3",
    "duration" : "9:18",
    "seller" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    }
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=72e40204-3a7b-41fa-a408-48a99e07afd7&streamSessionId=9736a887-0289-4e20-9ddb-afcc5a49b28c&code=john&expires=1646736789261&type=preview&ctrl=5bf5b8119de39f1f6db1c502712b26357a85ae56eebadbf126ae96c5029f9a90b33031e29078089f2308dfe24a91669a97440361fc3121f565074192900ed3c9",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-cbc0021d-5d40-4ce5-b28d-b358ae1275b5-tr.mp4/playlist.m3u8?token=72e40204-3a7b-41fa-a408-48a99e07afd7&streamSessionId=9736a887-0289-4e20-9ddb-afcc5a49b28c&code=john&expires=1646736789261&type=preview&ctrl=5bf5b8119de39f1f6db1c502712b26357a85ae56eebadbf126ae96c5029f9a90b33031e29078089f2308dfe24a91669a97440361fc3121f565074192900ed3c9"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-cbc0021d-5d40-4ce5-b28d-b358ae1275b5-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=72e40204-3a7b-41fa-a408-48a99e07afd7&streamSessionId=9736a887-0289-4e20-9ddb-afcc5a49b28c&code=john&expires=1646736789261&type=preview&ctrl=5bf5b8119de39f1f6db1c502712b26357a85ae56eebadbf126ae96c5029f9a90b33031e29078089f2308dfe24a91669a97440361fc3121f565074192900ed3c9",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-cbc0021d-5d40-4ce5-b28d-b358ae1275b5-tr.mp4?token=72e40204-3a7b-41fa-a408-48a99e07afd7&streamSessionId=9736a887-0289-4e20-9ddb-afcc5a49b28c&code=john&expires=1646736789261&type=preview&ctrl=5bf5b8119de39f1f6db1c502712b26357a85ae56eebadbf126ae96c5029f9a90b33031e29078089f2308dfe24a91669a97440361fc3121f565074192900ed3c9"
}

Response fields

See Plays a free content.

Resource fields

See Reads a Market Place item.

Live channels

A WimLive channel is a stream through which you can broadcast your live events to your public.

Creates a new live channel

$ curl 'http://platform.wim.tv:8080/api/live/channel' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "3ad7bc81-56ed-4d0a-a5c9-47463672943a",
  "streamPath" : "channel1",
  "public" : true,
  "name" : "Channel 1"
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

name

String

Name.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

streamPath

String

The stream path. You should generate the path through by the API /api/public/live/streampath.

* Required.
* Length must be between 0 and 128 inclusive.
* Must not be blank.

public

Boolean

Whether the live channel has to be visible in public pages or not. See Searches for live channels in public pages and Searches for live events in public pages.

* Optional.

thumbnailId

String

Identifier of the thumbnail to assign to the live channel.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 201 Created
Content-Length: 308
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "3ad7bc81-56ed-4d0a-a5c9-47463672943a",
  "channelId" : "3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
  "public" : true,
  "name" : "Channel 1"
}

Response fields

See Reads a live channel.

Reads a live channel in private pages

$ curl 'http://platform.wim.tv:8080/api/live/channel/3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/live/channel/{channelId}

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 308
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "3ad7bc81-56ed-4d0a-a5c9-47463672943a",
  "channelId" : "3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
  "public" : true,
  "name" : "Channel 1"
}

Response fields

Path Type Description

channelId

String

The live channel identifier.

name

String

Name.

description

String

Description. May be not provided.

streamingBaseUrl

URI

The streaming base URL.

streamPath

String

The stream path.

public

Boolean

Whether the live channel is visible in public pages or not. See Searches for live channels in public pages and Searches for live events in public pages.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads a live channel in public pages

$ curl 'http://platform.wim.tv:8080/api/public/live/channel/410c87ad-797a-442a-b85d-e546a9aa0eac' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/live/channel/{channelId}

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 530

{
  "description" : "Science",
  "tags" : [ "archeology", "history", "nature", "technology" ],
  "thumbnailId" : "9beba520-59eb-4db4-b111-6355851c0662",
  "channelId" : "410c87ad-797a-442a-b85d-e546a9aa0eac",
  "publisher" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  },
  "name" : "JoeTV 3"
}

Response fields

Path Type Description

channelId

String

The live channel identifier.

name

String

Name.

description

String

Description. May be not provided.

publisher

User

The publisher.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing live channel

$ curl 'http://platform.wim.tv:8080/api/live/channel/3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "streamPath" : "channel1",
  "public" : true,
  "name" : "Channel 1"
}'

Path parameters

/api/live/channel/{channelId}

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Creates a new live channel.

Response

HTTP/1.1 200 OK
Content-Length: 249
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "channelId" : "3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
  "public" : true,
  "name" : "Channel 1"
}

Response fields

See Reads a live channel.

Deletes an existing live channel

$ curl 'http://platform.wim.tv:8080/api/live/channel/3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/live/channel/{channelId}

Parameter Description

channelId

The live channel identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/live/channels' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "technology",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

public

Boolean

Whether the channels have to be visible in public pages.

* Optional.

Query string

The query string applies on the following fields:

  • Name

  • Description

  • Tags

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 811

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Science",
    "tags" : [ "archeology", "history", "nature", "technology" ],
    "thumbnailId" : "3e459741-ec9e-4137-9513-99020cf4bd68",
    "channelId" : "9bac8641-7400-482a-82bd-bb4a8d625f34",
    "streamPath" : "joetv3",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "JoeTV 3"
  }, {
    "description" : "Educational",
    "tags" : [ "computer", "hardware", "maths", "software", "technology" ],
    "thumbnailId" : "0643933d-d6dd-4eaf-b949-277e814cf732",
    "channelId" : "4c06f599-e189-44a1-9cd2-dc9d32265423",
    "streamPath" : "joetv1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "JoeTV 1"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a live channel.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Name

Searches for live channels in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/live/channels' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "technology",
  "pageIndex" : 0
}'
If the public field of a channel is set to false, that channel is excluded from the search.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

Query string

The query string applies on the following fields:

  • Channel

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.7; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Length: 1233
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Science",
    "tags" : [ "archeology", "history", "nature", "technology" ],
    "thumbnailId" : "9beba520-59eb-4db4-b111-6355851c0662",
    "channelId" : "410c87ad-797a-442a-b85d-e546a9aa0eac",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "JoeTV 3"
  }, {
    "description" : "Educational",
    "tags" : [ "computer", "hardware", "maths", "software", "technology" ],
    "thumbnailId" : "ee636d5b-33fa-49c5-8983-4aefcaff7280",
    "channelId" : "6971d5db-ff4c-4d46-b793-4f1f558f44f5",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "JoeTV 1"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a live channel.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Name

Generates a new stream path

$ curl 'http://platform.wim.tv:8080/api/public/live/streampath?base=mychannel' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request headers

Name Description

Accept

application/json

* Required.

Request parameters

Parameter Description

base

The base name for the path. You should set the the name of the channel to which assign the stream path.

* Optional.

Response

HTTP/1.1 200 OK
Content-Length: 32
Content-Type: application/json;charset=UTF-8

{
  "streamPath" : "mychannel"
}

Response fields

Path Type Description

streamPath

String

The generated path.

Plays the on-air live event in a channel

This API acts as the transaction API in a 3-steps payment flow, but it is only a kind of shortcut to play a live channel avoiding to specify the current on-air event; however the response includes the data of the detected event, thus, if the event is not free, you can proceed with the payment and then with the playing using the APIs for the live event (see Pays to play a live event and Plays a live event). Anyway there is not a payment API to play a live channel. 
$ curl 'http://platform.wim.tv:8080/api/live/channel/0a1b5e82-c006-4d75-a112-7737e3f66e93/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Path parameters

/api/live/channel/{channelId}/play

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

If the live event is free, you should not provide none of the request fields, otherwise you must provide the parameters to check for the succeeded payment.

Response

HTTP/1.1 200 OK
Content-Length: 2387
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "description" : "Episode 1",
    "tags" : [ "ishikawa", "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "12:18:04"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "60b52a1b-a54e-4fae-a245-a0507791d2e4",
      "channelId" : "0a1b5e82-c006-4d75-a112-7737e3f66e93",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "aea68f77-6a86-4c8e-aae7-7e99c7e77f9e",
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "11:55:34"
    },
    "name" : "Getter Robo"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/live?token=d9279f6d-46b2-4c93-b842-0254dc5f6b8b&streamSessionId=5728158e-8182-43a5-a178-59252c25d455&code=john&expires=1646736785049&ctrl=e20399c4bb4076a0635548ab68f6e7bbc7fd0b33459ce948ca9d291fa93a8362a00160688a81036a0ac89111a56b1d13b59dc9e3bde28afac9ef7bbc6b324f89",
    "uniqueStreamer" : "http://www.wim.tv:1935/live/joetv2_aac/playlist.m3u8?token=d9279f6d-46b2-4c93-b842-0254dc5f6b8b&streamSessionId=5728158e-8182-43a5-a178-59252c25d455&code=john&expires=1646736785049&ctrl=e20399c4bb4076a0635548ab68f6e7bbc7fd0b33459ce948ca9d291fa93a8362a00160688a81036a0ac89111a56b1d13b59dc9e3bde28afac9ef7bbc6b324f89"
  } ],
  "mimeType" : "video/flash",
  "file" : "joetv2_aac",
  "streamer" : "http://www.wim.tv:1935/live?token=d9279f6d-46b2-4c93-b842-0254dc5f6b8b&streamSessionId=5728158e-8182-43a5-a178-59252c25d455&code=john&expires=1646736785049&ctrl=e20399c4bb4076a0635548ab68f6e7bbc7fd0b33459ce948ca9d291fa93a8362a00160688a81036a0ac89111a56b1d13b59dc9e3bde28afac9ef7bbc6b324f89",
  "uniqueStreamer" : "http://www.wim.tv:1935/live/joetv2_aac?token=d9279f6d-46b2-4c93-b842-0254dc5f6b8b&streamSessionId=5728158e-8182-43a5-a178-59252c25d455&code=john&expires=1646736785049&ctrl=e20399c4bb4076a0635548ab68f6e7bbc7fd0b33459ce948ca9d291fa93a8362a00160688a81036a0ac89111a56b1d13b59dc9e3bde28afac9ef7bbc6b324f89"
}

Response fields

If the live event is free or the payment has succeeded, the response includes the parameters to setup your player, otherwise the response notifies that you have to pay.

Resource fields

See Reads a live event.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/live/channel/8a07f704-6e61-408e-85c3-31c517801c42/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Tests a live channel

You can test if your encoder is properly configured to broadcast through a live channel with no need to define an event.

$ curl 'http://platform.wim.tv:8080/api/live/channel/3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb/test' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/live/channel/{channelId}/test

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 1774
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "description" : "Description 1",
    "tags" : [ "tag1", "tag2" ],
    "thumbnailId" : "3ad7bc81-56ed-4d0a-a5c9-47463672943a",
    "channelId" : "3dcf55e7-c0d0-49f8-a7b5-6d4e0f7bf7bb",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "Channel 1"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/live?token=aac47a1a-9227-4594-8973-3f5cac40a977&streamSessionId=4b084c80-25d7-4c4c-bbeb-b89d0a5ab930&code=john&expires=1646736783858&ctrl=8060bab07fcfd30933a6945a420efe2d73ed4ea45c8da46e4b7fc8f793ba5914c30753325d04a50f7e77fdc4156ca6252e8d71e45cf9809b9d306dab33944758",
    "uniqueStreamer" : "http://www.wim.tv:1935/live/channel1_aac/playlist.m3u8?token=aac47a1a-9227-4594-8973-3f5cac40a977&streamSessionId=4b084c80-25d7-4c4c-bbeb-b89d0a5ab930&code=john&expires=1646736783858&ctrl=8060bab07fcfd30933a6945a420efe2d73ed4ea45c8da46e4b7fc8f793ba5914c30753325d04a50f7e77fdc4156ca6252e8d71e45cf9809b9d306dab33944758"
  } ],
  "mimeType" : "video/flash",
  "file" : "channel1_aac",
  "streamer" : "http://www.wim.tv:1935/live?token=aac47a1a-9227-4594-8973-3f5cac40a977&streamSessionId=4b084c80-25d7-4c4c-bbeb-b89d0a5ab930&code=john&expires=1646736783858&ctrl=8060bab07fcfd30933a6945a420efe2d73ed4ea45c8da46e4b7fc8f793ba5914c30753325d04a50f7e77fdc4156ca6252e8d71e45cf9809b9d306dab33944758",
  "uniqueStreamer" : "http://www.wim.tv:1935/live/channel1_aac?token=aac47a1a-9227-4594-8973-3f5cac40a977&streamSessionId=4b084c80-25d7-4c4c-bbeb-b89d0a5ab930&code=john&expires=1646736783858&ctrl=8060bab07fcfd30933a6945a420efe2d73ed4ea45c8da46e4b7fc8f793ba5914c30753325d04a50f7e77fdc4156ca6252e8d71e45cf9809b9d306dab33944758"
}

Response fields

See Plays a free content.

Resource fields

See Reads a live channel.

Live events

A WimLive event defines the time when you encode an event on a WimLive channel and the conditions (i.e. the price to pay) under which a viewer can watch your event.

Creates a new live event

$ curl 'http://platform.wim.tv:8080/api/live/channel/bbfc205b-e636-4d65-a01b-f15a8f432af5/event' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "86f43045-7464-4866-a717-863978a7a5c5",
  "paymentMode" : "FREE",
  "eventDate" : {
    "date" : "29/10/2016",
    "time" : "14:00:00"
  },
  "endDate" : {
    "date" : "29/10/2016",
    "time" : "14:30:00"
  },
  "recordEvent" : true,
  "publicEvent" : false,
  "name" : "Event 1"
}'

Path parameters

/api/live/channel/{channelId}/event

Parameter Description

channelId

The live channel identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

name

String

Title.

* Required.
* Length must be between 0 and 50 inclusive.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

paymentMode

License Type

License type.

* Required.
* Must not be null.

pricePerView

Amount

Price per view.

* Must be set only if the license type is PAY_PER_VIEW.
* Must be at least 0 (inclusive=false).

eventDate

DateTime

The date and time when the event starts.

* Required.

endDate

DateTime

The date and time when the event ends.

* Required.

publicEvent

Boolean

Whether the live event has to be visible in public pages or not. See Searches for live events in public pages.

* Optional.

recordEvent

Boolean

Whether the live event has to be recorded or not.

* Optional.

thumbnailId

String

Identifier of the thumbnail to assign to the live event.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 763

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "endDate" : {
    "date" : "29/10/2016",
    "time" : "14:30:00"
  },
  "channel" : {
    "description" : "Educational",
    "tags" : [ "computer", "hardware", "maths", "software", "technology" ],
    "thumbnailId" : "9c448440-10cf-466b-b6b9-0703c6ab394a",
    "channelId" : "bbfc205b-e636-4d65-a01b-f15a8f432af5",
    "streamPath" : "joetv1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "JoeTV 1"
  },
  "onAir" : false,
  "eventId" : "6f09a613-2851-4b9a-a78d-414c22d07255",
  "paymentMode" : "FREE",
  "eventDate" : {
    "date" : "29/10/2016",
    "time" : "14:00:00"
  },
  "name" : "Event 1",
  "publicEvent" : false,
  "recordEvent" : true
}

Response fields

See Reads a live event.

Reads a live event in private pages

$ curl 'http://platform.wim.tv:8080/api/live/event/6f09a613-2851-4b9a-a78d-414c22d07255' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/live/event/{eventId}

Parameter Description

eventId

The live event identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 763

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "endDate" : {
    "date" : "29/10/2016",
    "time" : "14:30:00"
  },
  "channel" : {
    "description" : "Educational",
    "tags" : [ "computer", "hardware", "maths", "software", "technology" ],
    "thumbnailId" : "9c448440-10cf-466b-b6b9-0703c6ab394a",
    "channelId" : "bbfc205b-e636-4d65-a01b-f15a8f432af5",
    "streamPath" : "joetv1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "JoeTV 1"
  },
  "onAir" : false,
  "eventId" : "6f09a613-2851-4b9a-a78d-414c22d07255",
  "paymentMode" : "FREE",
  "eventDate" : {
    "date" : "29/10/2016",
    "time" : "14:00:00"
  },
  "name" : "Event 1",
  "publicEvent" : false,
  "recordEvent" : true
}

Response fields

Path Type Description

eventId

String

The live event identifier.

name

String

Title.

description

String

Description. May be not provided.

channel

Channel

Live channel.

paymentMode

License Type

License type.

pricePerView

Amount

Price per view. Provided only if the license type is PAY_PER_VIEW.

eventDate

DateTime

The date when the event starts.

endDate

DateTime

The date when the event ends.

publicEvent

Boolean

Whether the live event is visible in public pages or not. See Searches for live events in public pages.

recordEvent

Boolean

Whether the live event has to be recorded or not.

onAir

Boolean

Whether the event is on-air.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads a live event in public pages

$ curl 'http://platform.wim.tv:8080/api/public/live/event/79e87c4d-d89a-42a4-b4b6-bdd446b98e5d' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/live/event/{eventId}

Parameter Description

eventId

The live event identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 870

{
  "description" : "Episode 1",
  "tags" : [ "nagai" ],
  "endDate" : {
    "date" : "07/03/2022",
    "time" : "09:53:00"
  },
  "channel" : {
    "description" : "Anime",
    "tags" : [ "japan", "manga" ],
    "thumbnailId" : "4c9fa4e2-796b-462c-a7ca-ccaa11ac06ca",
    "channelId" : "a3679c67-548c-432e-bf94-40d1c3a69cf7",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "JoeTV 2"
  },
  "onAir" : false,
  "eventId" : "79e87c4d-d89a-42a4-b4b6-bdd446b98e5d",
  "paymentMode" : "FREE",
  "eventDate" : {
    "date" : "07/03/2022",
    "time" : "08:53:00"
  },
  "name" : "Mazinger Z"
}

Response fields

Path Type Description

eventId

String

The live event identifier.

name

String

Title.

description

String

Description. May be not provided.

channel

Channel

Live channel.

paymentMode

License Type

License type.

pricePerView

Amount

Price per view. Provided only if the license type is PAY_PER_VIEW.

eventDate

DateTime

The date when the event starts.

endDate

DateTime

The date when the event ends.

onAir

Boolean

Whether the event is on-air.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing live event

$ curl 'http://platform.wim.tv:8080/api/live/event/6f09a613-2851-4b9a-a78d-414c22d07255' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "pricePerView" : "2,50",
  "paymentMode" : "PAY_PER_VIEW",
  "eventDate" : {
    "date" : "29/10/2016",
    "time" : "14:30:00"
  },
  "endDate" : {
    "date" : "29/10/2016",
    "time" : "15:00:00"
  },
  "recordEvent" : false,
  "publicEvent" : true,
  "name" : "Event 1"
}'

Path parameters

/api/live/event/{eventId}

Parameter Description

eventId

The live event identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Creates a new live event.

Response

HTTP/1.1 200 OK
Content-Length: 797
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "endDate" : {
    "date" : "29/10/2016",
    "time" : "15:00:00"
  },
  "channel" : {
    "description" : "Educational",
    "tags" : [ "computer", "hardware", "maths", "software", "technology" ],
    "thumbnailId" : "9c448440-10cf-466b-b6b9-0703c6ab394a",
    "channelId" : "bbfc205b-e636-4d65-a01b-f15a8f432af5",
    "streamPath" : "joetv1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
    "public" : true,
    "name" : "JoeTV 1"
  },
  "onAir" : false,
  "eventId" : "6f09a613-2851-4b9a-a78d-414c22d07255",
  "paymentMode" : "PAY_PER_VIEW",
  "eventDate" : {
    "date" : "29/10/2016",
    "time" : "14:30:00"
  },
  "pricePerView" : "2,50",
  "name" : "Event 1",
  "publicEvent" : true,
  "recordEvent" : false
}

Response fields

See Reads a live event.

Deletes an existing live event

$ curl 'http://platform.wim.tv:8080/api/live/event/6f09a613-2851-4b9a-a78d-414c22d07255' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/live/event/{eventId}

Parameter Description

eventId

The live event identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/live/events' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pastIncluded" : true,
  "pageSize" : 20,
  "queryString" : "nagai ishikawa",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

channelId

String

The live channel identifier.

* Optional.
* Length must be between 0 and 36 inclusive.

public

Boolean

Whether the events have to be visible in public pages.

* Optional.

recorded

Boolean

Whether the events have to be recorded.

* Optional.

pastIncluded

Boolean

Whether the events in the past should be included.

* Optional.

conditions

Object

Streaming conditions.

* Optional.

Query string

The query string applies on the following fields:

  • Event

    • Title

    • Description

    • Tags

  • Channel (boost: 0.7; if not provided as filter)

    • Name

    • Description

    • Tags

Response

HTTP/1.1 200 OK
Content-Length: 2520
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "myPlayHlsUrl" : "http://www.wim.tv:1935/live/joetv2_aac/playlist.m3u8?token=6c34bcf8-8213-4dfa-b0d5-47ebb7c10b41&streamSessionId=c9211166-dc94-49d0-9e1c-c62c31c13185&code=john&expires=2524608000000&playUrl=true&ctrl=56a6a53c0b87c060d2e22b6506268bfdd35c3bca679e2d94b2bf8a9ad394b1e3b5bb1c45c9379c798d20a2618b284b004ba124c55b7050e4dab62f180d7517ba",
    "description" : "Episode 1",
    "tags" : [ "ishikawa", "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "13:18:05"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "82755e1c-b3f4-4407-ad2c-8e16fba09581",
      "channelId" : "35b2386d-af0a-4466-aee9-8023ef01c1a7",
      "streamPath" : "joetv2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
      "public" : true,
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "bf84ae6f-f72d-4f92-9401-5abe6e77df8e",
    "playUrlExpireDate" : {
      "date" : "01/01/2050",
      "time" : "01:00:00"
    },
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "12:55:35"
    },
    "name" : "Getter Robo",
    "publicEvent" : true,
    "recordEvent" : false
  }, {
    "myPlayHlsUrl" : "http://www.wim.tv:1935/live/joetv2_aac/playlist.m3u8?token=3c5c6df7-a82a-4eef-8fa2-b63e1bad024f&streamSessionId=b825730b-c90a-4b90-a794-810f6fb7ac7b&code=john&expires=2524608000000&playUrl=true&ctrl=de9907ffabac47eb0a791263da141ca807a3e4f40b03e2ee05e266adee6a6e76aa80860a37dcea9aedcb205c5da616a1183d05fad331820177a4a37622a54513",
    "description" : "Episode 1",
    "tags" : [ "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "09:53:05"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "82755e1c-b3f4-4407-ad2c-8e16fba09581",
      "channelId" : "35b2386d-af0a-4466-aee9-8023ef01c1a7",
      "streamPath" : "joetv2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/live",
      "public" : true,
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "01fdb205-ed16-47ea-b4fd-6fb5835e87e4",
    "playUrlExpireDate" : {
      "date" : "01/01/2050",
      "time" : "01:00:00"
    },
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "08:53:05"
    },
    "name" : "Mazinger Z",
    "publicEvent" : true,
    "recordEvent" : false
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a live event.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Start time

  3. End time

Searches for live events in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/live/events' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "nagai ishikawa",
  "pageIndex" : 0
}'
If the publicEvent field of an event is set to false, that event is excluded from the search.
If the public field of a channel is set to false, all events published on that channel are excluded from the search.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

channelId

String

The live channel identifier.

* Optional.
* Length must be between 0 and 36 inclusive.

conditions

Object

Streaming conditions.

* Optional.

Query string

The query string applies on the following fields:

  • Event

    • Title

    • Description

    • Tags

  • Channel (boost: 0.7; if not provided as filter)

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.5; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1976

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Episode 1",
    "tags" : [ "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "09:53:00"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "4c9fa4e2-796b-462c-a7ca-ccaa11ac06ca",
      "channelId" : "a3679c67-548c-432e-bf94-40d1c3a69cf7",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "79e87c4d-d89a-42a4-b4b6-bdd446b98e5d",
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "08:53:00"
    },
    "name" : "Mazinger Z"
  }, {
    "description" : "Episode 1",
    "tags" : [ "ishikawa", "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "13:18:00"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "4c9fa4e2-796b-462c-a7ca-ccaa11ac06ca",
      "channelId" : "a3679c67-548c-432e-bf94-40d1c3a69cf7",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "168088ca-e9b3-4a93-b88b-c150d4042761",
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "12:55:30"
    },
    "name" : "Getter Robo"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a live event

Sort

The items are sorted by the following fields:

  1. Start time

  2. End time

Path Type Description

paymentMode

License Type

License type.

* Optional.

Plays a live event

This API acts as the transaction API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/live/event/ae2b25cf-98d2-4cad-8aba-42459bb4df08/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Path parameters

/api/live/event/{eventId}/play

Parameter Description

eventId

The live event identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

If the live event is free, you should not provide none of the request fields, otherwise you must provide the parameters to check for the succeeded payment.

Response

HTTP/1.1 200 OK
Content-Length: 2387
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "description" : "Episode 1",
    "tags" : [ "ishikawa", "nagai" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "12:17:59"
    },
    "channel" : {
      "description" : "Anime",
      "tags" : [ "japan", "manga" ],
      "thumbnailId" : "14d41bfe-3f01-43b4-b83e-49d7dba17497",
      "channelId" : "cf1870b6-6a42-48c9-9df5-f17656ba1ca2",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "JoeTV 2"
    },
    "onAir" : false,
    "eventId" : "ae2b25cf-98d2-4cad-8aba-42459bb4df08",
    "paymentMode" : "FREE",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "11:55:29"
    },
    "name" : "Getter Robo"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/live?token=cf597439-e925-4f7d-ab44-62f87497127a&streamSessionId=668e1c9f-1e2d-4857-9d95-071c6e00b853&code=john&expires=1646736780281&ctrl=80b42bad75cbb019d901092d9e76f2eb46aa89e9a1807cc00a828af0359cd780994d0416a86f2d7412fdb5a76b8053974afb84e2a48e816e1e2bd394fa1f7746",
    "uniqueStreamer" : "http://www.wim.tv:1935/live/joetv2_aac/playlist.m3u8?token=cf597439-e925-4f7d-ab44-62f87497127a&streamSessionId=668e1c9f-1e2d-4857-9d95-071c6e00b853&code=john&expires=1646736780281&ctrl=80b42bad75cbb019d901092d9e76f2eb46aa89e9a1807cc00a828af0359cd780994d0416a86f2d7412fdb5a76b8053974afb84e2a48e816e1e2bd394fa1f7746"
  } ],
  "mimeType" : "video/flash",
  "file" : "joetv2_aac",
  "streamer" : "http://www.wim.tv:1935/live?token=cf597439-e925-4f7d-ab44-62f87497127a&streamSessionId=668e1c9f-1e2d-4857-9d95-071c6e00b853&code=john&expires=1646736780281&ctrl=80b42bad75cbb019d901092d9e76f2eb46aa89e9a1807cc00a828af0359cd780994d0416a86f2d7412fdb5a76b8053974afb84e2a48e816e1e2bd394fa1f7746",
  "uniqueStreamer" : "http://www.wim.tv:1935/live/joetv2_aac?token=cf597439-e925-4f7d-ab44-62f87497127a&streamSessionId=668e1c9f-1e2d-4857-9d95-071c6e00b853&code=john&expires=1646736780281&ctrl=80b42bad75cbb019d901092d9e76f2eb46aa89e9a1807cc00a828af0359cd780994d0416a86f2d7412fdb5a76b8053974afb84e2a48e816e1e2bd394fa1f7746"
}

Response fields

If the live event is free or the payment has succeeded, the response includes the parameters to setup your player, otherwise the response notifies that you have to pay.

Resource fields

See Reads a live event.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/live/event/dad9ca21-2c09-48fe-a1ed-ab1cf7a190fe/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Pays to play a live event

This API acts as the payment API in a 3-steps payment flow. 
$ curl 'http://platform.wim.tv:8080/api/live/event/66ba4878-5c68-4c1d-944e-37fec04cc7e0/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/live/event/play",
  "cancelUrl" : "http://platform.wim.tv/live/event/rejected",
  "embedded" : false,
  "mobile" : false
}'

Path parameters

/api/live/event/{eventId}/pay

Parameter Description

eventId

The live event identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 1243
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "db7a9c1a-79d5-4000-b581-917961723aa7",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "description" : "From Masai Park to Mara Park and return",
    "tags" : [ "nature" ],
    "endDate" : {
      "date" : "07/03/2022",
      "time" : "12:42:59"
    },
    "channel" : {
      "description" : "Science",
      "tags" : [ "archeology", "history", "nature", "technology" ],
      "thumbnailId" : "c09f0973-c80e-40d3-9b49-4eedc91f2cf2",
      "channelId" : "6d645236-fb28-46b3-94f5-8b66f07669bf",
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "JoeTV 3"
    },
    "onAir" : false,
    "eventId" : "66ba4878-5c68-4c1d-944e-37fec04cc7e0",
    "paymentMode" : "PAY_PER_VIEW",
    "eventDate" : {
      "date" : "07/03/2022",
      "time" : "11:55:29"
    },
    "pricePerView" : "2,50",
    "name" : "African predators and prey"
  }
}

Response fields

See Gets the payment parameters.

Resource fields

See Reads a live event.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/live/event/8c4b5ba5-e0fa-47da-8fc5-28e18174c70e/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/live/event/play",
  "cancelUrl" : "http://platform.wim.tv/live/event/rejected",
  "embedded" : false,
  "mobile" : false
}'

WimCast channels

A WimCast channel is a stream on which you can schedule your programs (live events or prerecorded shows) and through which your public can watch them.

Creates a new WimCast channel

$ curl 'http://platform.wim.tv:8080/api/cast/channel' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "0f0b9c82-cd61-46bf-9002-34255dc7a07c",
  "streamPath" : "channel1",
  "name" : "Channel 1"
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

name

String

Name.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

streamPath

String

The stream path. You should generate the path through by the API /api/public/cast/streampath.

* Required.
* Length must be between 0 and 128 inclusive.
* Must not be blank.

thumbnailId

String

Identifier of the thumbnail to assign to the channel.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 201 Created
Content-Length: 316
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "0f0b9c82-cd61-46bf-9002-34255dc7a07c",
  "channelId" : "635d71e5-e8ca-400a-90b5-64b0033cabba",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "locked" : false,
  "name" : "Channel 1"
}

Response fields

See Reads a WimCast channel.

Reads a WimCast channel in private pages

$ curl 'http://platform.wim.tv:8080/api/cast/channel/635d71e5-e8ca-400a-90b5-64b0033cabba' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}

Parameter Description

channelId

The WimCast channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 316
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "0f0b9c82-cd61-46bf-9002-34255dc7a07c",
  "channelId" : "635d71e5-e8ca-400a-90b5-64b0033cabba",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "locked" : false,
  "name" : "Channel 1"
}

Response fields

Path Type Description

channelId

String

The WimCast channel identifier.

name

String

Name.

description

String

Description. May be not provided.

locked

Boolean

Describes whether the channel is 'locked' or not.

streamingBaseUrl

URI

The streaming base URL.

streamPath

String

The stream path.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads a WimCast channel in public pages

$ curl 'http://platform.wim.tv:8080/api/public/cast/channel/2f2c440d-4cda-40eb-aaea-cad5a1e00595' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/cast/channel/{channelId}

Parameter Description

channelId

The channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 533
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 2",
  "tags" : [ "ch20", "ch21", "ch22" ],
  "thumbnailId" : "191c3522-2261-49ba-809f-060147793a40",
  "channelId" : "2f2c440d-4cda-40eb-aaea-cad5a1e00595",
  "locked" : false,
  "publisher" : {
    "userCode" : "john",
    "licenseExpired" : false,
    "pageTitle" : "WimLabs",
    "pageDescription" : "Video Communications",
    "facebookUrl" : "http://www.facebook.com/wimlabs",
    "twitterContact" : "@wimlabs",
    "linkedinUrl" : "http://www.linkedin.com/wimlabs"
  },
  "name" : "Channel 2"
}

Response fields

Path Type Description

channelId

String

The WimCast channel identifier.

name

String

Name.

description

String

Description. May be not provided.

locked

Boolean

Describes whether the channel is 'locked' or not.

publisher

User

The publisher.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing WimCast channel

$ curl 'http://platform.wim.tv:8080/api/cast/channel/635d71e5-e8ca-400a-90b5-64b0033cabba' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "streamPath" : "channel1",
  "name" : "Channel 1"
}'

Path parameters

/api/cast/channel/{channelId}

Parameter Description

channelId

The WimCast channel identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Creates a new WimCast channel.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 257

{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "channelId" : "635d71e5-e8ca-400a-90b5-64b0033cabba",
  "streamPath" : "channel1",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "locked" : false,
  "name" : "Channel 1"
}

Response fields

See Reads a WimCast channel.

Deletes an existing WimCast channel

$ curl 'http://platform.wim.tv:8080/api/cast/channel/635d71e5-e8ca-400a-90b5-64b0033cabba' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}

Parameter Description

channelId

The WimCast channel identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/cast/channels' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "ch10 ch21",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

Query string

The query string applies on the following fields:

  • Name

  • Description

  • Tags

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 783

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Description 2",
    "tags" : [ "ch20", "ch21", "ch22" ],
    "thumbnailId" : "8e3f295d-2866-42e5-95af-e5086682b606",
    "channelId" : "79f4e72c-8c06-479c-a4e7-70947328e9db",
    "streamPath" : "channel2",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 2"
  }, {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "50aa9036-60c6-42e1-940d-a99691806af3",
    "channelId" : "fe5ce91b-4188-41d0-b89e-c5265e8bc853",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a WimCast channel.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Name

Searches for WimCast channels in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/cast/channels' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pageSize" : 20,
  "queryString" : "ch10 ch21",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.

Query string

The query string applies on the following fields:

  • Channel

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.7; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1229

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Description 2",
    "tags" : [ "ch20", "ch21", "ch22" ],
    "thumbnailId" : "191c3522-2261-49ba-809f-060147793a40",
    "channelId" : "2f2c440d-4cda-40eb-aaea-cad5a1e00595",
    "locked" : false,
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "Channel 2"
  }, {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "1d30443a-ad01-4d19-9af9-e63d4db64b9d",
    "channelId" : "7bf1bce3-95b6-4dbd-a8d1-ad9777ef613a",
    "locked" : false,
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "Channel 1"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a WimCast channel.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Name

Generates a new stream path

$ curl 'http://platform.wim.tv:8080/api/public/cast/streampath?base=mychannel' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request headers

Name Description

Accept

application/json

* Required.

Request parameters

Parameter Description

base

The base name for the path. You should set the the name of the channel or the name of the live stream to which assign the stream path.

* Optional.

Response

HTTP/1.1 200 OK
Content-Length: 32
Content-Type: application/json;charset=UTF-8

{
  "streamPath" : "mychannel"
}

Response fields

Path Type Description

streamPath

String

The generated path.

Plays a WimCast channel

$ curl 'http://platform.wim.tv:8080/api/cast/channel/93c243ae-dd96-4d2a-b1ca-554730c74c1d/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}/play

Parameter Description

channelId

The WimCast channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2029

{
  "resource" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "b23aa04e-9a22-418d-af13-42689a5fd8a2",
    "channelId" : "93c243ae-dd96-4d2a-b1ca-554730c74c1d",
    "locked" : false,
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "Channel 1"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/programming?token=0f87c1ae-db77-4ac2-8fba-b4cb90d3d07c&streamSessionId=36fc109c-20c3-459d-b9bd-732e9aa8407c&code=john&expires=1646736765731&ctrl=a0b662af3ee7566881fead77cdf4da845e89551b112a1ccbe5101de4848c6363aea5789fc402d7cacacddde6aee8c9c3975804a64cb8ada89c50f1e3d376946d",
    "uniqueStreamer" : "http://www.wim.tv:1935/programming/channel1/playlist.m3u8?token=0f87c1ae-db77-4ac2-8fba-b4cb90d3d07c&streamSessionId=36fc109c-20c3-459d-b9bd-732e9aa8407c&code=john&expires=1646736765731&ctrl=a0b662af3ee7566881fead77cdf4da845e89551b112a1ccbe5101de4848c6363aea5789fc402d7cacacddde6aee8c9c3975804a64cb8ada89c50f1e3d376946d"
  } ],
  "mimeType" : "video/flash",
  "file" : "channel1",
  "streamer" : "http://www.wim.tv:1935/programming?token=0f87c1ae-db77-4ac2-8fba-b4cb90d3d07c&streamSessionId=36fc109c-20c3-459d-b9bd-732e9aa8407c&code=john&expires=1646736765731&ctrl=a0b662af3ee7566881fead77cdf4da845e89551b112a1ccbe5101de4848c6363aea5789fc402d7cacacddde6aee8c9c3975804a64cb8ada89c50f1e3d376946d",
  "uniqueStreamer" : "http://www.wim.tv:1935/programming/channel1?token=0f87c1ae-db77-4ac2-8fba-b4cb90d3d07c&streamSessionId=36fc109c-20c3-459d-b9bd-732e9aa8407c&code=john&expires=1646736765731&ctrl=a0b662af3ee7566881fead77cdf4da845e89551b112a1ccbe5101de4848c6363aea5789fc402d7cacacddde6aee8c9c3975804a64cb8ada89c50f1e3d376946d"
}

Response fields

See Plays a free content.

Resource fields

See Reads a WimCast channel.

Unauthenticated users

The same API is available to non authenticated users through by another end-point.

$ curl 'http://platform.wim.tv:8080/api/public/cast/channel/8167ac79-2b4f-49b0-a2cf-7252a5ce71fd/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Tests a WimCast channel

You can check for the properly broadcasting of a WimCast channel.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/635d71e5-e8ca-400a-90b5-64b0033cabba/test' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}/test

Parameter Description

channelId

The WimCast channel identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1798

{
  "resource" : {
    "description" : "Description 1",
    "tags" : [ "tag1", "tag2" ],
    "thumbnailId" : "0f0b9c82-cd61-46bf-9002-34255dc7a07c",
    "channelId" : "635d71e5-e8ca-400a-90b5-64b0033cabba",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/programming?token=631b7673-d471-459f-bdaf-eaf94d7c61f6&streamSessionId=58816057-aa9d-48b3-af21-e4312dfca48f&code=john&expires=1646736774868&ctrl=1a175012dde9e02069df7c2ea7a16b9b899d76b18422b780a1a2c9b626cd45f99e45cf3d614a59e7172acf7b7957d0edad7fbe657261d708946e0ee9dff167c2",
    "uniqueStreamer" : "http://www.wim.tv:1935/programming/channel1/playlist.m3u8?token=631b7673-d471-459f-bdaf-eaf94d7c61f6&streamSessionId=58816057-aa9d-48b3-af21-e4312dfca48f&code=john&expires=1646736774868&ctrl=1a175012dde9e02069df7c2ea7a16b9b899d76b18422b780a1a2c9b626cd45f99e45cf3d614a59e7172acf7b7957d0edad7fbe657261d708946e0ee9dff167c2"
  } ],
  "mimeType" : "video/flash",
  "file" : "channel1",
  "streamer" : "http://www.wim.tv:1935/programming?token=631b7673-d471-459f-bdaf-eaf94d7c61f6&streamSessionId=58816057-aa9d-48b3-af21-e4312dfca48f&code=john&expires=1646736774868&ctrl=1a175012dde9e02069df7c2ea7a16b9b899d76b18422b780a1a2c9b626cd45f99e45cf3d614a59e7172acf7b7957d0edad7fbe657261d708946e0ee9dff167c2",
  "uniqueStreamer" : "http://www.wim.tv:1935/programming/channel1?token=631b7673-d471-459f-bdaf-eaf94d7c61f6&streamSessionId=58816057-aa9d-48b3-af21-e4312dfca48f&code=john&expires=1646736774868&ctrl=1a175012dde9e02069df7c2ea7a16b9b899d76b18422b780a1a2c9b626cd45f99e45cf3d614a59e7172acf7b7957d0edad7fbe657261d708946e0ee9dff167c2"
}

Response fields

See Plays a free content.

Resource fields

See Reads a WimCast channel.

WimCast live streams

A WimCast live stream is a stream on which you can encode your live events in order to broadcast them through by a WimCast channel.

Creates a new live stream

$ curl 'http://platform.wim.tv:8080/api/cast/stream' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "76ed493a-725a-4898-b1da-d76ae1dfd486",
  "streamPath" : "stream1",
  "name" : "Stream 1"
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

name

String

Name.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

streamPath

String

The stream path. You should generate the path through by the API /api/public/cast/streampath.

* Required.
* Length must be between 0 and 128 inclusive.
* Must not be blank.

thumbnailId

String

Identifier of the thumbnail to assign to the stream.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 201 Created
Content-Length: 293
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "76ed493a-725a-4898-b1da-d76ae1dfd486",
  "streamPath" : "stream1",
  "streamId" : "728b8562-3918-490d-b4aa-be47ea0317c5",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "name" : "Stream 1"
}

Response fields

See Reads a live stream.

Reads a live stream

$ curl 'http://platform.wim.tv:8080/api/cast/stream/728b8562-3918-490d-b4aa-be47ea0317c5' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/stream/{streamId}

Parameter Description

streamId

The live stream identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 293
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag1", "tag2" ],
  "thumbnailId" : "76ed493a-725a-4898-b1da-d76ae1dfd486",
  "streamPath" : "stream1",
  "streamId" : "728b8562-3918-490d-b4aa-be47ea0317c5",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "name" : "Stream 1"
}

Response fields

Path Type Description

streamId

String

The live stream identifier.

name

String

Name.

description

String

Description. May be not provided.

streamingBaseUrl

URI

The streaming base URL.

streamPath

String

The stream path.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing live stream

$ curl 'http://platform.wim.tv:8080/api/cast/stream/728b8562-3918-490d-b4aa-be47ea0317c5' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "streamPath" : "stream1",
  "name" : "Stream 1"
}'

Path parameters

/api/cast/stream/{streamId}

Parameter Description

streamId

The live stream identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

See Creates a new live stream.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 234

{
  "description" : "Description modified",
  "tags" : [ "tag3" ],
  "streamPath" : "stream1",
  "streamId" : "728b8562-3918-490d-b4aa-be47ea0317c5",
  "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
  "name" : "Stream 1"
}

Response fields

See Reads a live stream.

Deletes an existing live stream

$ curl 'http://platform.wim.tv:8080/api/cast/stream/728b8562-3918-490d-b4aa-be47ea0317c5' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/stream/{streamId}

Parameter Description

streamId

The live stream identifier.

Response

HTTP/1.1 204 No Content
$ curl 'http://platform.wim.tv:8080/api/search/cast/streams' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "pageSize" : 20,
  "queryString" : "st10 st21",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.

pagination

Boolean

whether to paginate the results

* Optional.

Query string

The query string applies on the following fields:

  • Name

  • Description

  • Tags

Response

HTTP/1.1 200 OK
Content-Length: 733
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 20,
  "items" : [ {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "46879037-9a9f-4314-8638-0938406e1bb2",
    "streamPath" : "stream1",
    "streamId" : "1f3caad4-2639-4417-b8e1-2b23368a1104",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "name" : "Stream 1"
  }, {
    "description" : "Description 2",
    "tags" : [ "st20", "st21", "st22" ],
    "thumbnailId" : "9a604535-6c0e-444a-ac48-c34de2654376",
    "streamPath" : "stream2",
    "streamId" : "fe362523-a462-46e8-89c7-177d1193ae67",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "name" : "Stream 2"
  } ],
  "pageIndex" : 0,
  "totalCount" : 2,
  "pageCount" : 1
}

Response fields

See Searching for data.

Item fields

See Reads a live stream.

Sort

The items are sorted by the following fields:

  1. Relevance

  2. Name

Tests a live stream

You can test if your encoder is properly configured to broadcast through a live stream with no need to define a program.

$ curl 'http://platform.wim.tv:8080/api/cast/stream/728b8562-3918-490d-b4aa-be47ea0317c5/test' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/stream/{streamId}/test

Parameter Description

streamId

The live stream identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 1782
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "description" : "Description 1",
    "tags" : [ "tag1", "tag2" ],
    "thumbnailId" : "76ed493a-725a-4898-b1da-d76ae1dfd486",
    "streamPath" : "stream1",
    "streamId" : "728b8562-3918-490d-b4aa-be47ea0317c5",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "name" : "Stream 1"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/programming?token=faf1c284-9e44-44c7-8d6f-d8817df62082&streamSessionId=a7b77a82-7dfc-4b86-adc9-6b4884283d9e&code=john&expires=1646736765125&ctrl=25da3634f06a79850342a8e176d903bbe4e4c10aaea57407e9800b8bce065302a365f171862802e81fba1ac0d2ca418ce83df77cb2ea463be9328e8c2ac193df",
    "uniqueStreamer" : "http://www.wim.tv:1935/programming/stream1_aac/playlist.m3u8?token=faf1c284-9e44-44c7-8d6f-d8817df62082&streamSessionId=a7b77a82-7dfc-4b86-adc9-6b4884283d9e&code=john&expires=1646736765125&ctrl=25da3634f06a79850342a8e176d903bbe4e4c10aaea57407e9800b8bce065302a365f171862802e81fba1ac0d2ca418ce83df77cb2ea463be9328e8c2ac193df"
  } ],
  "mimeType" : "video/flash",
  "file" : "stream1_aac",
  "streamer" : "http://www.wim.tv:1935/programming?token=faf1c284-9e44-44c7-8d6f-d8817df62082&streamSessionId=a7b77a82-7dfc-4b86-adc9-6b4884283d9e&code=john&expires=1646736765125&ctrl=25da3634f06a79850342a8e176d903bbe4e4c10aaea57407e9800b8bce065302a365f171862802e81fba1ac0d2ca418ce83df77cb2ea463be9328e8c2ac193df",
  "uniqueStreamer" : "http://www.wim.tv:1935/programming/stream1_aac?token=faf1c284-9e44-44c7-8d6f-d8817df62082&streamSessionId=a7b77a82-7dfc-4b86-adc9-6b4884283d9e&code=john&expires=1646736765125&ctrl=25da3634f06a79850342a8e176d903bbe4e4c10aaea57407e9800b8bce065302a365f171862802e81fba1ac0d2ca418ce83df77cb2ea463be9328e8c2ac193df"
}

Response fields

See Plays a free content.

Resource fields

See Reads a live stream.

WimCast programs

Let’s start with a definition of the noun program from http://translate.google.com/#en/it/programming:

the action or process of scheduling something, especially radio or television programs.
the programming of shows

In WimCast, a programming is a sequence of programs broadcasted by a channel.

A program has a start-time and an end-time. The unit of time is the second.

In an instant T, a channel is broadcasting the program if T is equal or after the program start-time, and T is before the program end-time.

A program starts in a day if the start-time is equal or after that day at 00:00:00, and the end-time is before the next day at 00:00:00.
A program that starts in a day may end in the next day, but should not be longer than 24 hours.

Usually, the first program in a day may start in that day from 00:00:00 until at 23:59:59.
However, the start-time of the programming in a day may depend from the end-time of the last program started the previous day.
For example, if the last program starts in a day and finishes in the next day at 01:40:00, the the first program in the next day may start that day from 01:40:00 until at 23:59:59.

You schedule the programs in a channel day-by-day.

Reads a program in private pages

$ curl 'http://platform.wim.tv:8080/api/cast/program/dbde5df0-7a0b-4a65-924f-ad3e2f32aad9' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/program/{programId}

Parameter Description

programId

The WimCast program identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 715
Content-Type: application/json;charset=UTF-8

{
  "stream" : {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "848a5e3b-f116-4de4-a832-4a8ec890930a",
    "streamPath" : "stream1",
    "streamId" : "1bd67d35-16cf-4265-9277-3da9c3d91825",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "name" : "Stream 1"
  },
  "description" : "Description 1",
  "tags" : [ "st10", "st11", "st12" ],
  "thumbnailId" : "848a5e3b-f116-4de4-a832-4a8ec890930a",
  "startDate" : {
    "date" : "07/03/2025",
    "time" : "04:10:15"
  },
  "endDate" : {
    "date" : "07/03/2025",
    "time" : "04:18:39"
  },
  "title" : "Stream 1",
  "itemType" : "LIVE",
  "programId" : "dbde5df0-7a0b-4a65-924f-ad3e2f32aad9"
}

Response fields

Path Type Description

programId

String

The WimCast program identifier.

title

String

Title.

description

String

Description. May be not provided.

startDate

DateTime

The start-time.

endDate

DateTime

The end-time.

itemType

Item Type

Program type.

boxContent

Object

The content. Provided only if the item type is PRERECORDED.

stream

Object

The live stream. Provided only if the item type is LIVE.

offset

Number

Offset where to start playing the content (seconds). May be provided only if the item type is PRERECORDED.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Content fields

Path Type Description

boxId

String

The WimBox item identifier.

contentId

String

The content identifier.

title

String

Title.

description

String

Description. May be not provided.

resourceId

String

The resource identifier.

duration

Duration

Duration.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Reads a program in public pages

$ curl 'http://platform.wim.tv:8080/api/public/cast/program/c36ed7b2-7c24-4849-8eef-e920c3f198ed' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/public/cast/program/{programId}

Parameter Description

programId

The WimCast program identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 973
Content-Type: application/json;charset=UTF-8

{
  "description" : "Description 1",
  "tags" : [ "tag10", "tag11", "tag12" ],
  "thumbnailId" : "8d50934d-54d8-4d9f-a0f2-5953bb184910",
  "startDate" : {
    "date" : "07/03/2025",
    "time" : "04:43:55"
  },
  "endDate" : {
    "date" : "07/03/2025",
    "time" : "04:53:31"
  },
  "title" : "Title 1",
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "1d30443a-ad01-4d19-9af9-e63d4db64b9d",
    "channelId" : "7bf1bce3-95b6-4dbd-a8d1-ad9777ef613a",
    "locked" : false,
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "name" : "Channel 1"
  },
  "itemType" : "PRERECORDED",
  "programId" : "c36ed7b2-7c24-4849-8eef-e920c3f198ed"
}

Response fields

Path Type Description

programId

String

The WimCast program identifier.

title

String

Title.

description

String

Description. May be not provided.

channel

Channel

The channel.

startDate

DateTime

The start-time.

endDate

DateTime

The end-time.

itemType

Item Type

Program type.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Updates an existing program

Using this API you can update only the descriptive data of a program: if you want to update when a program starts or ends, you should use the WimCast daily programming APIs.

$ curl 'http://platform.wim.tv:8080/api/cast/program/dbde5df0-7a0b-4a65-924f-ad3e2f32aad9' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "description" : "Description modified",
  "tags" : [ "m1", "m2" ],
  "title" : "Title modified"
}'

Path parameters

/api/cast/program/{programId}

Parameter Description

programId

The WimCast program identifier.

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

title

String

Title.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

thumbnailId

String

Identifier of the thumbnail to assign to the program.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 200 OK
Content-Length: 658
Content-Type: application/json;charset=UTF-8

{
  "stream" : {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "848a5e3b-f116-4de4-a832-4a8ec890930a",
    "streamPath" : "stream1",
    "streamId" : "1bd67d35-16cf-4265-9277-3da9c3d91825",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "name" : "Stream 1"
  },
  "description" : "Description modified",
  "tags" : [ "m1", "m2" ],
  "startDate" : {
    "date" : "07/03/2025",
    "time" : "04:10:15"
  },
  "endDate" : {
    "date" : "07/03/2025",
    "time" : "04:18:39"
  },
  "title" : "Title modified",
  "itemType" : "LIVE",
  "programId" : "dbde5df0-7a0b-4a65-924f-ad3e2f32aad9"
}

Response fields

See Reads a program.

Searches for WimCast programs in public pages

$ curl 'http://platform.wim.tv:8080/api/public/search/cast/programs/dummy' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "tags" : [ ],
  "pagination" : true,
  "pageSize" : 3,
  "queryString" : "ch10 ch21",
  "pageIndex" : 0
}'

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

pageSize

Number

Number of item per page.

* Required.
* Must be at least 1.

pageIndex

Number

Index of the page to read.

* Required.
* Must be at least 0.

queryString

String

Query string.

* Optional.

tags

Array

Tags of items.

* Optional.
* Length of each element must be between 1 and 80.

pagination

Boolean

whether to paginate the results

* Optional.

userCode

String

A user code.

* Optional.
* Length must be between 0 and 50 inclusive.

channelId

String

The WimCast channel identifier.

* Optional.
* Length must be between 0 and 36 inclusive.

Query string

The query string applies on the following fields:

  • Program

    • Title

    • Description

    • Tags

  • Channel (boost: 0.7; if not provided as filter)

    • Name

    • Description

    • Tags

  • Publisher (boost: 0.5; if not provided as filter)

    • Username

    • First name

    • Last name

    • Page title

    • Page description

Response

HTTP/1.1 200 OK
Content-Length: 3212
Content-Type: application/json;charset=UTF-8

{
  "pageSize" : 3,
  "items" : [ {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "8d50934d-54d8-4d9f-a0f2-5953bb184910",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:29:35"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:39:11"
    },
    "title" : "Title 1",
    "channel" : {
      "description" : "Description 2",
      "tags" : [ "ch20", "ch21", "ch22" ],
      "thumbnailId" : "191c3522-2261-49ba-809f-060147793a40",
      "channelId" : "2f2c440d-4cda-40eb-aaea-cad5a1e00595",
      "locked" : false,
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "Channel 2"
    },
    "itemType" : "PRERECORDED",
    "programId" : "82d2c177-972d-4b73-abef-9a6117fc4c1e"
  }, {
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "thumbnailId" : "bd23d578-3a21-4a85-923f-d248344cb100",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:39:55"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:45:52"
    },
    "title" : "Title 2",
    "channel" : {
      "description" : "Description 2",
      "tags" : [ "ch20", "ch21", "ch22" ],
      "thumbnailId" : "191c3522-2261-49ba-809f-060147793a40",
      "channelId" : "2f2c440d-4cda-40eb-aaea-cad5a1e00595",
      "locked" : false,
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "Channel 2"
    },
    "itemType" : "PRERECORDED",
    "programId" : "d53eafdb-163c-48fe-ad1f-1c42becdb790"
  }, {
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "thumbnailId" : "bd23d578-3a21-4a85-923f-d248344cb100",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:45:52"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:51:49"
    },
    "title" : "Title 2",
    "channel" : {
      "description" : "Description 2",
      "tags" : [ "ch20", "ch21", "ch22" ],
      "thumbnailId" : "191c3522-2261-49ba-809f-060147793a40",
      "channelId" : "2f2c440d-4cda-40eb-aaea-cad5a1e00595",
      "locked" : false,
      "publisher" : {
        "userCode" : "john",
        "licenseExpired" : false,
        "pageTitle" : "WimLabs",
        "pageDescription" : "Video Communications",
        "facebookUrl" : "http://www.facebook.com/wimlabs",
        "twitterContact" : "@wimlabs",
        "linkedinUrl" : "http://www.linkedin.com/wimlabs"
      },
      "name" : "Channel 2"
    },
    "itemType" : "PRERECORDED",
    "programId" : "e5ea415b-2364-47eb-8c29-6aa13e5e2f0a"
  } ],
  "pageIndex" : 0,
  "totalCount" : 20,
  "pageCount" : 7
}

Response fields

See Searching for data.

Item fields

See Reads a WimCast program.

Sort

The items are sorted by the following fields:

  1. Start time

  2. End time

WimCast daily programming

You schedule the programs in a channel day-by-day.
You schedule the programs in a day within a daily timetable from the start-time (when the first program may start) to end-time (when the last program ends).

The programs sequence must be continuous, that is each program starts when the previous program finishes.
You can insert a break between two programs as a special kind of program, called BREAK, with a start-time and an end-time.

Reads a daily programming

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 2332
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:35:22"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:35:22"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:44:16"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "6b2c57e1-edbd-4ea0-bd4d-a464dd0af9fa"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:44:16"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:52:08"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "ad7a18ce-534f-4adb-8506-86d034f8a3f4"
  } ]
}

Response fields

Path Type Description

channel

Channel

WimCast channel.

targetDate

Date

The programming date.

startDateMin

DateTime

Minimum start-time of the programs.

endDateMax

DateTime

Maximum end-time of the programs.

programs

Array

Array of programs.

programsCount

Number

Number of programs.

Program fields

Path Type Description

programId

String

The WimCast program identifier. Provided only if item type is PRERECORDED or LIVE.

title

String

Title.

description

String

Description. May be not provided.

startDate

DateTime

The start-time.

endDate

DateTime

The end-time.

itemType

Item Type

Program type.

boxContent

Object

The content. Provided only if the item type is PRERECORDED.

stream

Object

The live stream. Provided only if the item type is LIVE.

offset

Number

Offset where to start playing the content (seconds). May be provided only if the item type is PRERECORDED.

thumbnailId

String

The thumbnail identifier. May be not provided.

tags

Array of String

Array of tags. May be not provided.

Saves a daily programming

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "programs" : [ {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "sourceId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "title" : "Stream 1",
    "programType" : "LIVE"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "sourceId" : "559e11de-e264-404e-83cb-98af99ba41fb",
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "title" : "Title 1",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0",
    "programType" : "PRERECORDED"
  }, {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "sourceId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "title" : "Stream 1",
    "programType" : "LIVE"
  }, {
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "sourceId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "05:13:02"
    },
    "title" : "Stream 1",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c",
    "programType" : "LIVE"
  } ]
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

programs

Array

Array of programs.

* Required.
The programs array must be properly sorted by startDate and endDate properties, otherwise you could get errors about programs that overlap each other.

Program fields

Path Type Description

programId

String

The program identifier.

* Must be set only if program already exists.
* Length must be between 0 and 36 inclusive.

title

String

Title.

* Required.
* Length must be between 0 and 50 inclusive.
* Must not be blank.

description

String

Description.

* Optional.
* Length must be between 0 and 400 inclusive.

startDate

DateTime

Start-time.

* Required.
* Must not be null.

endDate

DateTime

End-time.

* Required.
* Must not be null.

programType

Item Type

Program type.

* Required.
* Must not be null.

sourceId

String

The source identifier (WimBox item, WimCast live stream).

* Required.
* Length must be between 0 and 36 inclusive.
* Must not be blank.

offset

Number

Offset where to start playing the content (seconds).

* May be provided only if the item type is PRERECORDED.
* Must be at least 0.

thumbnailId

String

Identifier of the thumbnail to assign to the program.

* Optional.
* Length must be between 0 and 36 inclusive.

tags

Array of String

Array of tags.

* Optional.
* Length of each element must be between 1 and 80.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3728

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "48535eeb-d0ca-499c-9be7-a724865bcaed"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "7636ba08-face-45dc-bcf2-a607dba2f30d"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "05:13:02"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  } ]
}

Response fields

See Reads a daily programming.

Removes all programs from a daily programming

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307' -i -X DELETE \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 586

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ ]
}

Response fields

See Reads a daily programming.

Inserts one or more programs in a daily programming

You can pick up one or more programs to insert in the daily timetable from the following sources:

  • The contents in your WimBox.

  • The live streams in your WimCast. If you select one or more live streams, you have to set the duration of the broadcasting for each selected stream.

  • The programs scheduled in another channel in a certain day.

  • The programs scheduled in the same channel for another day.

  • The BREAK. If you insert a BREAK, you have to set its duration.


  • If you insert a program at the beginning of the daily timetable, the start-time is set to the start-time of the timetable, and the end-time is calculated in order to preserve the duration of the program.

  • If you insert a program below another program, the start-time is set to the end-time of the previous program, and the end-time is calculated in order to preserve the duration of the program.

If you have selected more than one program, the further programs are inserted below the first, and the start-time and the end-time of each program are calculated in order to preserve the duration of each program and to keep the programs sequence continuous.

Anyway, the programs below the insertion point are shifted in order to preserve the duration of each program and to keep the programs sequence continuous.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/insert' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "sourceItems" : [ {
    "sourceType" : "PRERECORDED",
    "sourceId" : "0390b75d-55b7-4777-a42c-f4e9d45ae068"
  }, {
    "sourceType" : "PROGRAM",
    "sourceId" : "35227946-803a-4c14-9569-1740710bf03f"
  }, {
    "sourceType" : "BREAK",
    "duration" : 1200
  } ],
  "index" : 1
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/insert

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Insertion index.

* Required.
* Must be at least 0.

sourceItems

Array

Items to insert.

* Required.
* Must not be null.

Program source

Path Type Description

sourceType

Source Type

Source type.

* Required.
* Must not be null.

sourceId

String

The source identifier (WimBox item, WimCast live stream or WimCast program).

* Must be set only if the source type is PRERECORDED or LIVE or PROGRAM.
* Length must be between 0 and 36 inclusive.

duration

Number

Duration (seconds).

* Must be set only if the source type is LIVE or BREAK.
* Must be at least 1.

Response

HTTP/1.1 200 OK
Content-Length: 4245
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "thumbnailId" : "ec406d8d-3453-4f90-baea-c14d0cb74e99",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:05:11"
    },
    "title" : "Title 2",
    "boxContent" : {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "boxId" : "0390b75d-55b7-4777-a42c-f4e9d45ae068",
      "contentId" : "urn:wim:tv:content:6b965316-fc01-48af-973a-469e47a74e75",
      "resourceId" : "a32e0606-f1f4-4374-b692-26051efaf85e",
      "thumbnailId" : "ec406d8d-3453-4f90-baea-c14d0cb74e99",
      "title" : "Title 2",
      "duration" : "5:11"
    },
    "itemType" : "PRERECORDED",
    "programId" : "a98c0e75-5802-4b82-a41e-31ee071c59b5"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:05:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:05:11"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  }, {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:05:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:25:11"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:25:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:25:11"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "35227946-803a-4c14-9569-1740710bf03f"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:25:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:31:33"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  } ]
}

Response fields

See Reads a daily programming.

Moves a program in a daily programming

You can move the programs along the daily timetable.

  • If you move a program at the beginning of the daily timetable, the start-time is moved at the start-time of the timetable, and the end-time is recalculated in order to preserve the program duration.

  • If you move a program below another program, the start-time is moved at the end-time of the previous program, and the end-time is recalculated to preserve the program duration.

Anyway, the other programs are shifted in order to preserve the duration of each program and to keep the programs sequence continuous.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/move' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "fromIndex" : 1,
  "toIndex" : 4
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/move

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

fromIndex

Number

Index of the program to move.

* Required.
* Must be at least 0.

toIndex

Number

Index of the program before of which insert the moved program.

* Required.
* Must be at least 0.

Response

HTTP/1.1 200 OK
Content-Length: 4245
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:00:00"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  }, {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:20:00"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "description" : "Description 2",
    "tags" : [ "tag20", "tag21", "tag22" ],
    "thumbnailId" : "ec406d8d-3453-4f90-baea-c14d0cb74e99",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:20:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:25:11"
    },
    "title" : "Title 2",
    "boxContent" : {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "boxId" : "0390b75d-55b7-4777-a42c-f4e9d45ae068",
      "contentId" : "urn:wim:tv:content:6b965316-fc01-48af-973a-469e47a74e75",
      "resourceId" : "a32e0606-f1f4-4374-b692-26051efaf85e",
      "thumbnailId" : "ec406d8d-3453-4f90-baea-c14d0cb74e99",
      "title" : "Title 2",
      "duration" : "5:11"
    },
    "itemType" : "PRERECORDED",
    "programId" : "a98c0e75-5802-4b82-a41e-31ee071c59b5"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "03:25:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:25:11"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "35227946-803a-4c14-9569-1740710bf03f"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:25:11"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:31:33"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  } ]
}

Response fields

See Reads a daily programming.

Splits a program

You can split a program, for example, in order to insert a BREAK or an advertising.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/split' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "index" : 1,
  "offset" : 191
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/split

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Index of the program to split.

* Required.
* Must be at least 0.

offset

Number

Offset where to split the program (seconds).

* Required.
* Must be at least 1.

Response

HTTP/1.1 200 OK
Content-Length: 4596
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "48535eeb-d0ca-499c-9be7-a724865bcaed"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:19:51"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:19:51"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "9ef72b59-1db2-4ecd-a9c8-be67112d8546",
    "offset" : 191
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "7636ba08-face-45dc-bcf2-a607dba2f30d"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:29:42"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "05:13:02"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  } ]
}

Response fields

See Reads a daily programming.

Removes one or more programs from a daily programming

You can remove one or more programs from a daily timetable.
The succeeding programs are shifted in order to preserve the duration of each program and to keep the programs sequence continuous.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/remove' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "count" : 3,
  "index" : 2
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/remove

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Index of the first program to remove.

* Required.
* Must be at least 0.

count

Number

Number of programs to remove.

* Required.
* Must be at least 1.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2415

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "00:06:22"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  }, {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:06:22"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:06:22"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:06:22"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "03:06:22"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  } ]
}

Response fields

See Reads a daily programming.

Updating the time when a program starts or ends

You can update the start-time or the end-time of a program, but this may involve the entire daily programming, so you have to update individually the start-time or the end-time.

  • If your update results in a empty space before the modified program, a BREAK is inserted in order to preserve the programs sequence continuous.

  • If your update results in a empty space after the modified program, the succeeding programs are moved back in order to preserve the duration of each program and to keep the programs sequence continuous.

  • If your update results in a overlap among the modified program and the succeeding programs, the succeeding programs are moved forward in order to preserve the duration of each program and to keep the programs sequence continuous.

Remember that a program in a timetable for a day, must start at or after that day at 00:00:00 and before the next day at 00:00:00, but may end the next day; however the programs in the timetable for a day can not overlap with programs scheduled in the previous day neither in the next day.

Updates the time when a program starts

  • You cannot move the start-time back.

  • If the program has been picked up from your WimBox, the end-time is recalculated in order to preserve the duration.

  • If the program has not been picked up from your WimBox,

    • If you keep the start-time before the end-time, the result is a shorter duration.

    • If you put the start-time equal or after the end-time, the end-time is recalculated in order to preserve the duration.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/startdate' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "startDate" : {
    "date" : "07/03/2025",
    "time" : "02:00:00"
  },
  "index" : 0
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/startdate

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Index of the program to update.

* Required.
* Must be at least 0.

startDate

DateTime

The new date when the program will start.

* Required.
* Must not be null.

Response

HTTP/1.1 200 OK
Content-Length: 2632
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:06:22"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  }, {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:06:22"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:06:22"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:06:22"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "05:06:22"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  } ]
}

Response fields

See Reads a daily programming.

Updates the time when a program ends

  • The end-time of a program cannot be equal to the start-time.

  • If the program has been picked up from your WimBox,

    • You cannot move the end-time back.

    • If you move forward the end-time, the start-time is recalculated in order to preserve the duration.

  • If the program has not been picked up from your WimBox, the start-time is kept, so:

    • If you move the end-time back, the result is a shorter duration.

    • If you move the end-time forward, the result is a longer duration.

$ curl 'http://platform.wim.tv:8080/api/cast/channel/c9f5b958-0ad1-4920-bf58-72beff6a6058/dailyprogramming/20250307/enddate' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "endDate" : {
    "date" : "07/03/2025",
    "time" : "02:16:40"
  },
  "index" : 0
}'

Path parameters

/api/cast/channel/{channelId}/dailyprogramming/{date}/enddate

Parameter Description

channelId

The WimCast channel identifier.

date

Programming date (yyyyMMdd).

Request headers

Name Description

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

index

Number

Index of the program to update.

* Required.
* Must be at least 0.

endDate

DateTime

The new date when the program will end.

* Required.
* Must not be null.

Response

HTTP/1.1 200 OK
Content-Length: 2632
Content-Type: application/json;charset=UTF-8

{
  "programsCount" : 0,
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "ed9391ba-6c57-497a-af48-b215a25edc19",
    "channelId" : "c9f5b958-0ad1-4920-bf58-72beff6a6058",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  },
  "targetDate" : "07/03/2025",
  "startDateMin" : {
    "date" : "07/03/2025",
    "time" : "00:00:00"
  },
  "endDateMax" : {
    "date" : "09/03/2025",
    "time" : "00:00:00"
  },
  "programs" : [ {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "00:00:00"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:16:40"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "title" : "Title 1",
    "boxContent" : {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "boxId" : "559e11de-e264-404e-83cb-98af99ba41fb",
      "contentId" : "urn:wim:tv:content:e71d6966-0ef1-4fa2-86b4-d22fd33097cc",
      "resourceId" : "f00dc840-880a-43ed-a269-84b0bbd11df3",
      "thumbnailId" : "d52f31a9-a97b-4b1c-a04f-2fd08a7c0918",
      "title" : "Title 1",
      "duration" : "6:22"
    },
    "itemType" : "PRERECORDED",
    "programId" : "21ca6fd7-3443-43cb-9075-e206d119e1b0"
  }, {
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "02:23:02"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "04:39:42"
    },
    "title" : "BREAK",
    "itemType" : "BREAK"
  }, {
    "stream" : {
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
      "streamPath" : "stream1",
      "streamId" : "ea5a318c-b84b-4561-9356-7b9a70f106f2",
      "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
      "name" : "Stream 1"
    },
    "description" : "Description 1",
    "tags" : [ "st10", "st11", "st12" ],
    "thumbnailId" : "4a8c1529-dcb6-4bab-855b-39193e8c1446",
    "startDate" : {
      "date" : "07/03/2025",
      "time" : "04:39:42"
    },
    "endDate" : {
      "date" : "07/03/2025",
      "time" : "05:23:02"
    },
    "title" : "Stream 1",
    "itemType" : "LIVE",
    "programId" : "88d59292-bff8-4110-888a-75a62dfa7a7c"
  } ]
}

Response fields

See Reads a daily programming.

WimCast programming calendar

Reads a programming

$ curl 'http://platform.wim.tv:8080/api/cast/channel/9c6b3920-044c-4408-b934-309daf00ce47/calendar/20250307/2?details=true' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Request parameters

Parameter Description

details

Whether the daily programming should be read.

* Default: false

Path parameters

/api/cast/channel/{channelId}/calendar/{startDate}/{dayCount}

Parameter Description

channelId

The WimCast channel identifier.

startDate

Start date of the programming (yyyyMMdd).

dayCount

Number of days of the programming.

You can select the daily programmings within any period you want.

Selects a week
$ curl 'http://www.wim.tv:8080/api/cast/channel/4e8ae0d0-f355-425a-9ee1-a63775b7d826/calendar/20201026/7' -i -H 'Accept: application/json' -H 'Accept-Language: it' -H 'X-Wimtv-timezone: 3600000'

October 2020

Mon

Tue

Wed

Thu

Fri

Sat

Sun

26

27

28

29

30

31

1 Nov
Selects a month
$ curl 'http://www.wim.tv:8080/api/cast/channel/4e8ae0d0-f355-425a-9ee1-a63775b7d826/calendar/20201001/31' -i -H 'Accept: application/json' -H 'Accept-Language: it' -H 'X-Wimtv-timezone: 3600000'
October 2020

1

2

3

…​

31
Selects a month of weekly programmings
$ curl 'http://www.wim.tv:8080/api/cast/channel/4e8ae0d0-f355-425a-9ee1-a63775b7d826/calendar/20200928/35' -i -H 'Accept: application/json' -H 'Accept-Language: it' -H 'X-Wimtv-timezone: 3600000'

October 2020

Mon

Tue

Wed

Thu

Fri

Sat

Sun

28 Sep

29 Sep

30 Sep

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

1 Nov

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 9001
Content-Type: application/json;charset=UTF-8

{
  "startDate" : "07/03/2025",
  "dailyProgrammings" : [ {
    "programsCount" : 5,
    "targetDate" : "07/03/2025",
    "programs" : [ {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "07/03/2025",
        "time" : "06:47:15"
      },
      "endDate" : {
        "date" : "07/03/2025",
        "time" : "06:55:15"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "3cc6b336-0be4-43d2-975d-480a33991654"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "07/03/2025",
        "time" : "06:56:05"
      },
      "endDate" : {
        "date" : "07/03/2025",
        "time" : "07:06:42"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "4072cd22-aa55-4fc3-b7b9-60208cfd8d12"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "07/03/2025",
        "time" : "07:06:42"
      },
      "endDate" : {
        "date" : "07/03/2025",
        "time" : "07:13:31"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "cd6f0c8a-5b31-4e96-a7c8-0c2c17097be1"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "07/03/2025",
        "time" : "07:13:31"
      },
      "endDate" : {
        "date" : "07/03/2025",
        "time" : "07:26:25"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "f84a1f28-cd35-4776-9f01-d46a0e9d3b0a"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "07/03/2025",
        "time" : "07:26:25"
      },
      "endDate" : {
        "date" : "07/03/2025",
        "time" : "07:32:42"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "3464e8f6-038a-4f0b-b861-5fb70739c1db"
    } ]
  }, {
    "programsCount" : 5,
    "targetDate" : "08/03/2025",
    "programs" : [ {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "08/03/2025",
        "time" : "07:31:10"
      },
      "endDate" : {
        "date" : "08/03/2025",
        "time" : "07:37:58"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "fe860c63-b0f4-4b59-a468-86ad586315d6"
    }, {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
      "startDate" : {
        "date" : "08/03/2025",
        "time" : "07:38:57"
      },
      "endDate" : {
        "date" : "08/03/2025",
        "time" : "07:48:25"
      },
      "title" : "Title 1",
      "boxContent" : {
        "description" : "Description 1",
        "tags" : [ "tag10", "tag11", "tag12" ],
        "boxId" : "d03ed418-db7e-4138-afa7-e62374c4ceec",
        "contentId" : "urn:wim:tv:content:0096ae85-060e-41bc-a58c-1355b6fb9302",
        "resourceId" : "8cc56476-b359-4a33-b3e8-1049f4595ec0",
        "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
        "title" : "Title 1",
        "duration" : "9:28"
      },
      "itemType" : "PRERECORDED",
      "programId" : "804847e9-938e-4f95-b828-140f45512d37"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "08/03/2025",
        "time" : "07:48:25"
      },
      "endDate" : {
        "date" : "08/03/2025",
        "time" : "08:00:32"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "2815c0bf-2408-4b67-a845-28acb532ed04"
    }, {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "08/03/2025",
        "time" : "08:00:32"
      },
      "endDate" : {
        "date" : "08/03/2025",
        "time" : "08:07:20"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "edd9cf57-4a14-4c56-a657-85063042cb86"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "08/03/2025",
        "time" : "08:07:20"
      },
      "endDate" : {
        "date" : "08/03/2025",
        "time" : "08:16:58"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "e28854e6-02f1-4ed1-8429-3acd67ec3baf"
    } ]
  } ],
  "endDate" : "08/03/2025",
  "channel" : {
    "description" : "Description 1",
    "tags" : [ "ch10", "ch11", "ch12" ],
    "thumbnailId" : "de9747d4-2c11-403c-bbac-e13371ffb031",
    "channelId" : "9c6b3920-044c-4408-b934-309daf00ce47",
    "streamPath" : "channel1",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 1"
  }
}

Response fields

Path Type Description

channel

Channel

WimCast channel.

startDate

Date

Start date of the programming.

endDate

Date

End date of the programming.

dailyProgrammings

Array

Array of daily programmings. May be empty.
The response includes always the whole selected period even the days with no programs within.

Programming fields

Path Type Description

targetDate

Date

The programming date.

programs

Array

Array of programs.

programsCount

Number

Number of programs.

Copies a period of daily programmings to another period

$ curl 'http://platform.wim.tv:8080/api/cast/calendar/copy/4dc11ddb-a9d3-49ed-be34-824d7130a2b8' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-progressbarId: daeeadcf-e036-4f37-b894-5a38b8d18eb4' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "destChannelId" : "4dc11ddb-a9d3-49ed-be34-824d7130a2b8",
  "sourceStartDate" : "07/03/2025",
  "sourceDayCount" : 2,
  "destStartDate" : "17/03/2025",
  "destDayCount" : 3,
  "sourceChannelId" : "9c6b3920-044c-4408-b934-309daf00ce47"
}'

Request headers

Name Description

X-Wimtv-progressbarId

The progress bar identifier. You can query the progress bar value through by the /api/progressbar/{progressbarId} API.

* Optional.

Content-Type

application/json

* Required.

Accept

application/json

* Required.

Request fields

Path Type Description

sourceChannelId

String

Source channel identifier.

* Required.
* Length must be between 0 and 36 inclusive.
* Must not be blank.

sourceStartDate

Date

Date of the first daily programming to copy.

* Required.
* Must not be null.

sourceDayCount

Number

Number of daily programmings to copy.

* Required.
* Must be at least 1.

destChannelId

String

Destination channel identifier. May be equal the source channel.

* Required.
* Length must be between 0 and 36 inclusive.
* Must not be blank.

destStartDate

Date

Date of the first day of the destination period.

* Required.
* Must not be null.

destDayCount

Number

Number of days in the destination period. It will be rounded-up to the nearest multiple of sourceDayCount not less than sourceDayCount.

* Required.
* Must be at least 1.

You can also replicate a period of daily programmings more than one time to a longer period.

Replicates a programming from a week to another week
$ curl 'http://www.wim.tv:8080/api/cast/calendar/copy' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: it' -H 'X-Wimtv-timezone: 3600000' -d '{
  "destChannelId" : "85348238-76a5-4f86-919d-77b0b635651d",
  "sourceStartDate" : "02/03/2020",
  "sourceDayCount" : 7,
  "destStartDate" : "16/03/2030",
  "destDayCount" : 1,
  "sourceChannelId" : "f3fd1ef2-a72d-49ff-8e75-0cf1f9a72a6b"
}'

March 2020

Copy from

to

2

16

3

17

4

18

5

19

6

20

7

21

8

22
Replicates a programming from a week to other two weeks
$ curl 'http://www.wim.tv:8080/api/cast/calendar/copy' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Accept-Language: it' -H 'X-Wimtv-timezone: 3600000' -d '{
  "destChannelId" : "85348238-76a5-4f86-919d-77b0b635651d",
  "sourceStartDate" : "12/10/2020",
  "sourceDayCount" : 7,
  "destStartDate" : "19/10/2020",
  "destDayCount" : 10,
  "sourceChannelId" : "f3fd1ef2-a72d-49ff-8e75-0cf1f9a72a6b"
}'

October 2020

Copy from

to

to

12

19

26

13

20

27

14

21

28

15

22

29

16

23

30

17

24

31

18

25

1 Nov

Response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 17556

{
  "startDate" : "17/03/2025",
  "dailyProgrammings" : [ {
    "programsCount" : 5,
    "targetDate" : "17/03/2025",
    "programs" : [ {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "17/03/2025",
        "time" : "06:47:15"
      },
      "endDate" : {
        "date" : "17/03/2025",
        "time" : "06:55:15"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "d470502e-d38e-4af3-9d50-ff5c7fa149d6"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "17/03/2025",
        "time" : "06:56:05"
      },
      "endDate" : {
        "date" : "17/03/2025",
        "time" : "07:06:42"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "0bc710dc-c244-4a25-94d7-4a651575731e"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "17/03/2025",
        "time" : "07:06:42"
      },
      "endDate" : {
        "date" : "17/03/2025",
        "time" : "07:13:31"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "902182e4-2c85-4c05-be63-21fe774502a2"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "17/03/2025",
        "time" : "07:13:31"
      },
      "endDate" : {
        "date" : "17/03/2025",
        "time" : "07:26:25"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "e1913473-b5a9-4bbb-82b1-5deca1c08a1a"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "17/03/2025",
        "time" : "07:26:25"
      },
      "endDate" : {
        "date" : "17/03/2025",
        "time" : "07:32:42"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "e25ed2ef-ed6a-468d-b9af-41c958ffb5a9"
    } ]
  }, {
    "programsCount" : 5,
    "targetDate" : "18/03/2025",
    "programs" : [ {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "18/03/2025",
        "time" : "07:31:10"
      },
      "endDate" : {
        "date" : "18/03/2025",
        "time" : "07:37:58"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "ddcf0553-8168-4637-928b-8988736e4db1"
    }, {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
      "startDate" : {
        "date" : "18/03/2025",
        "time" : "07:38:57"
      },
      "endDate" : {
        "date" : "18/03/2025",
        "time" : "07:48:25"
      },
      "title" : "Title 1",
      "boxContent" : {
        "description" : "Description 1",
        "tags" : [ "tag10", "tag11", "tag12" ],
        "boxId" : "d03ed418-db7e-4138-afa7-e62374c4ceec",
        "contentId" : "urn:wim:tv:content:0096ae85-060e-41bc-a58c-1355b6fb9302",
        "resourceId" : "8cc56476-b359-4a33-b3e8-1049f4595ec0",
        "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
        "title" : "Title 1",
        "duration" : "9:28"
      },
      "itemType" : "PRERECORDED",
      "programId" : "08169ffe-bfcc-4ff5-9f9a-fb421f9a079c"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "18/03/2025",
        "time" : "07:48:25"
      },
      "endDate" : {
        "date" : "18/03/2025",
        "time" : "08:00:32"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "5144f933-154c-403b-8da3-d742d2c7794f"
    }, {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "18/03/2025",
        "time" : "08:00:32"
      },
      "endDate" : {
        "date" : "18/03/2025",
        "time" : "08:07:20"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "de2b2cab-b87c-4036-a52b-cc73b906e748"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "18/03/2025",
        "time" : "08:07:20"
      },
      "endDate" : {
        "date" : "18/03/2025",
        "time" : "08:16:58"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "d8b3c86b-49dc-4953-ba74-92bca960a61a"
    } ]
  }, {
    "programsCount" : 5,
    "targetDate" : "19/03/2025",
    "programs" : [ {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "19/03/2025",
        "time" : "06:47:15"
      },
      "endDate" : {
        "date" : "19/03/2025",
        "time" : "06:55:15"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "39a8ad5c-a01a-479c-925d-a869d85d4842"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "19/03/2025",
        "time" : "06:56:05"
      },
      "endDate" : {
        "date" : "19/03/2025",
        "time" : "07:06:42"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "35996f0f-26cd-4119-bd79-7d6f82ea73d8"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "19/03/2025",
        "time" : "07:06:42"
      },
      "endDate" : {
        "date" : "19/03/2025",
        "time" : "07:13:31"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "3b7db34e-cfc0-4b7d-ad0c-c9c1a9f7ed69"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "19/03/2025",
        "time" : "07:13:31"
      },
      "endDate" : {
        "date" : "19/03/2025",
        "time" : "07:26:25"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "4695a3bc-0522-48e5-9318-c75ff9dc0373"
    }, {
      "stream" : {
        "description" : "Description 2",
        "tags" : [ "st20", "st21", "st22" ],
        "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
        "streamPath" : "stream2",
        "streamId" : "756c202c-c92b-4544-b88a-dedc4bf685e8",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 2"
      },
      "description" : "Description 2",
      "tags" : [ "st20", "st21", "st22" ],
      "thumbnailId" : "5f65a22f-5876-4355-b4c7-570a491b81e0",
      "startDate" : {
        "date" : "19/03/2025",
        "time" : "07:26:25"
      },
      "endDate" : {
        "date" : "19/03/2025",
        "time" : "07:32:42"
      },
      "title" : "Stream 2",
      "itemType" : "LIVE",
      "programId" : "a8187488-65d9-4e62-a167-9a020c2156fe"
    } ]
  }, {
    "programsCount" : 5,
    "targetDate" : "20/03/2025",
    "programs" : [ {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "20/03/2025",
        "time" : "07:31:10"
      },
      "endDate" : {
        "date" : "20/03/2025",
        "time" : "07:37:58"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "f0a61ec9-bb82-485f-aeba-66a833a196d4"
    }, {
      "description" : "Description 1",
      "tags" : [ "tag10", "tag11", "tag12" ],
      "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
      "startDate" : {
        "date" : "20/03/2025",
        "time" : "07:38:57"
      },
      "endDate" : {
        "date" : "20/03/2025",
        "time" : "07:48:25"
      },
      "title" : "Title 1",
      "boxContent" : {
        "description" : "Description 1",
        "tags" : [ "tag10", "tag11", "tag12" ],
        "boxId" : "d03ed418-db7e-4138-afa7-e62374c4ceec",
        "contentId" : "urn:wim:tv:content:0096ae85-060e-41bc-a58c-1355b6fb9302",
        "resourceId" : "8cc56476-b359-4a33-b3e8-1049f4595ec0",
        "thumbnailId" : "8cdb1bec-0bee-4ab8-809c-04abe4f455f2",
        "title" : "Title 1",
        "duration" : "9:28"
      },
      "itemType" : "PRERECORDED",
      "programId" : "4a6a644b-9106-4c33-8101-c84fa4bfb0d6"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "20/03/2025",
        "time" : "07:48:25"
      },
      "endDate" : {
        "date" : "20/03/2025",
        "time" : "08:00:32"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "8152f704-a97a-41bf-b570-f1ed9043642a"
    }, {
      "description" : "Description 2",
      "tags" : [ "tag20", "tag21", "tag22" ],
      "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
      "startDate" : {
        "date" : "20/03/2025",
        "time" : "08:00:32"
      },
      "endDate" : {
        "date" : "20/03/2025",
        "time" : "08:07:20"
      },
      "title" : "Title 2",
      "boxContent" : {
        "description" : "Description 2",
        "tags" : [ "tag20", "tag21", "tag22" ],
        "boxId" : "5c59c03d-cd4e-41ed-afc0-e76b9a887d9d",
        "contentId" : "urn:wim:tv:content:33c41fd8-642f-4a91-8e83-d8b530bde100",
        "resourceId" : "93de35bc-91ca-4236-a541-3841492a9fc6",
        "thumbnailId" : "0273a769-6bac-472d-a688-186974d29a7f",
        "title" : "Title 2",
        "duration" : "6:48"
      },
      "itemType" : "PRERECORDED",
      "programId" : "12b8a9ef-66ff-4ca2-9449-187235e626b6"
    }, {
      "stream" : {
        "description" : "Description 1",
        "tags" : [ "st10", "st11", "st12" ],
        "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
        "streamPath" : "stream1",
        "streamId" : "82414d2c-81c2-46ec-933a-e64bb51e9073",
        "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
        "name" : "Stream 1"
      },
      "description" : "Description 1",
      "tags" : [ "st10", "st11", "st12" ],
      "thumbnailId" : "1695d776-a2fc-4729-b490-a10200c48c7f",
      "startDate" : {
        "date" : "20/03/2025",
        "time" : "08:07:20"
      },
      "endDate" : {
        "date" : "20/03/2025",
        "time" : "08:16:58"
      },
      "title" : "Stream 1",
      "itemType" : "LIVE",
      "programId" : "b060cb2f-e438-4697-a986-84f8f525a9ff"
    } ]
  } ],
  "endDate" : "20/03/2025",
  "channel" : {
    "description" : "Description 2",
    "tags" : [ "ch20", "ch21", "ch22" ],
    "thumbnailId" : "3f82ffe2-352b-4d0b-b8a0-b45c041ec25b",
    "channelId" : "4dc11ddb-a9d3-49ed-be34-824d7130a2b8",
    "streamPath" : "channel2",
    "streamingBaseUrl" : "rtmp://www.wim.tv:1935/programming",
    "locked" : false,
    "name" : "Channel 2"
  }
}

Response fields

See Reads a programming.

The response includes always the whole destination period even the days with no programs within.
The response includes only the copied programs: if other programs have been already scheduled in the destination period, they are not included in the response.

Deletes a programming

$ curl 'http://platform.wim.tv:8080/api/cast/channel/9c6b3920-044c-4408-b934-309daf00ce47/calendar/20250307/2' -i -X DELETE \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/cast/channel/{channelId}/calendar/{startDate}/{dayCount}

Parameter Description

channelId

The WimCast channel identifier.

startDate

Start date of the programming (yyyyMMdd).

dayCount

Number of days of the programming.

Response

HTTP/1.1 204 No Content

Payments

A payment process is always built up on two APIs: one for getting the payment parameters and one for checking whether the payment has succeeded or not.

Payment flow

2-steps payment flow

  1. You call the Payment API.

  2. You have to redirect your browser to the PayPal service page reachable through by the url field in the response.

  3. If the user accepts the payment, PayPal redirects to your Web page reachable through by the returnUrl field in the request.

  4. If the user rejects the payment, PayPal redirects to your Web page reachable through by the cancelUrl field in the request.

  5. When the browser returns to your Web page, you should call the Payment check API.

  6. If the payment has succeeded, the transaction will be performed, otherwise you will get an error.

Sometimes a transaction may be free or not free, in such cases the flow is slightly different.

3-steps payment flow

  1. You call the transaction API.

  2. If the transaction is free, it will be performed and that’s all.

  3. If the transaction is not free, the API returns a payment request.

  4. Now you call the Payment API.

  5. You have to redirect your browser to the PayPal service page reachable through by the url field in the response.

  6. If the user accepts the payment, PayPal redirects to your Web page reachable through by the returnUrl field in the request.

  7. If the user rejects the payment, PayPal redirects to your Web page reachable through by the cancelUrl field in the request.

  8. When the browser returns to your Web page, you should call again the transaction API integrating the request fields with the parameters to check for the succeeded payment.

  9. If the payment has succeeded, the transaction will be performed, otherwise you will be asked for the payment again.

Gets the payment parameters

$ curl 'http://platform.wim.tv:8080/api/license/Professional/subscribe' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/license/accepted",
  "cancelUrl" : "http://platform.wim.tv/license/rejected",
  "embedded" : false,
  "mobile" : false
}'

Request fields

Path Type Description

returnUrl

String

URL where redirect to in case of succeeded payment.

* Required.
* Must be a well-formed URL.
* Must not be blank.

cancelUrl

String

URL where redirect to in case of rejected payment.

* Required.
* Must be a well-formed URL.
* Must not be blank.

embedded

Boolean

Whether the payment form has to be embedded in the client page.

* Optional.

mobile

Boolean

Whether the client is a mobile App.

* Optional.

advanceMonthlyPayments

Number

months to pay in advance

* Optional.

Response

HTTP/1.1 200 OK
Content-Length: 402
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "73ed582d-9a0d-4c22-bc42-de666da42966",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "price" : "14,90",
    "storage" : 50,
    "band" : 80,
    "maxVideoSize" : 2,
    "maxUploadNumber" : 50,
    "name" : "Professional",
    "id" : 3,
    "support" : "PHONE",
    "dayDuration" : 30
  }
}

Response fields

Path Type Description

trackingId

String

The payment tracking ID.

embedded

Boolean

Whether the payment form has to be embedded in the client page.

url

URI

The PayPal service URL.

expType

String

The experience type. May be not provided.

mobile

Boolean

Whether the client is a mobile App.

payKey

String

The pay key. Provided only if the client is a mobile device.

pendingRequest

Object

The request to send to the WimTV payment service. Provided only if the client is a mobile App.

resource

Object

Describes the subject of the payment.
The resource object is useful to prompt the user for the payment giving him all the infos he would like.

Embedded payment form

If you would embed the payment form in your Web page, you should use an IFRAME element like the following:

<iframe id="PPDGFrame" name="PPDGFrame"
        src="http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1?expType=light&payKey=09966b16-58ec-4920-ab63-f414c8544c47"
        scrolling="no" frameborder="0" allowtransparency="true"
        style="top: 0px; width: 385px; height: 550px; border: none;"></iframe>
As you can see, you should you use the fields url, expType and payKey in the response to setup your IFRAME.

Mobile App

If the client is a mobile App, that App should manage the payment flow on its own, thus the response includes the request to send to the WimTV payment service (field pendingRequest).

Checking whether a payment has succeeded or not

$ curl 'http://platform.wim.tv:8080/api/license/Professional/activate' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "trackingId" : "73ed582d-9a0d-4c22-bc42-de666da42966"
}'

Request fields

Path Type Description

trackingId

String

Payment tracking ID.

* Required.
* Length must be between 0 and 36 inclusive.

payKey

String

Pay key.

* Must be provided if the client is a mobile device.
* Length must be between 0 and 255 inclusive.

Response

The response usually describes the subject of the payment.

Playing and Payments

Plays a free content

$ curl 'http://platform.wim.tv:8080/api/vod/8a86aa39-d647-43fe-880a-89912ad9370d/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Response

HTTP/1.1 200 OK
Content-Length: 2402
Content-Type: application/json;charset=UTF-8

{
  "resource" : {
    "licenseType" : "FREE",
    "vodId" : "8a86aa39-d647-43fe-880a-89912ad9370d",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 1",
    "tags" : [ "tag10", "tag11", "tag12" ],
    "boxId" : "9d332df3-da02-4534-9884-49479f9ee5b4",
    "contentId" : "urn:wim:tv:content:7322a958-4922-4a3f-909d-82fa2e9f1ed1",
    "resourceId" : "05f7feea-24a8-4809-ab51-c6bd0ff37adc",
    "thumbnailId" : "d8554128-37ab-4208-b928-c5e152216875",
    "title" : "Title 1",
    "duration" : "8:34"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4/playlist.m3u8?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-74b06243-29f8-4094-81fb-273c97f3b1bf-tr.mp4?token=5d92f1d3-6cfa-4a65-8719-3ed1ce3e278a&streamSessionId=9ec801fb-21bc-43b3-96bb-8e2b9a528b88&code=john&expires=1646736799440&ctrl=a92464039ad1dde71b989f0a6424c1ac85701fa2545e89188c303e3c8a0c8152a61bbc54d3196dd3749e350aa46f30c9a9feb0b95862b56b40be662aee6e6825"
}

Response fields

The response includes the parameters to setup your player.

Path Type Description

result

Result

Result of the request.

mimeType

String

Mime Type stream to play.

file

String

Name of the stream to play.

streamer

URI

Base URL of the streaming application.

uniqueStreamer

URI

Full URL of the stream to play.

srcs

Array

Array of Objects for all the streamable sources

resource

Object

Describes the resource to play.
The resource object is useful to enrich your player page with infos about the content.

Plays a not free content

$ curl 'http://platform.wim.tv:8080/api/vod/e199a7c4-e7fd-4b68-8e21-ad819ca90a6c/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{ }'

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 873

{
  "resource" : {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "e199a7c4-e7fd-4b68-8e21-ad819ca90a6c",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "249f39f8-f921-4c43-83cf-bff44cd70d05",
    "contentId" : "urn:wim:tv:content:fccee630-da12-4065-999a-0c28f60fcafa",
    "resourceId" : "a80a7094-e9a6-4a01-8203-8c811cedc0ea",
    "thumbnailId" : "b1e42b65-2464-4b45-8a71-353549596a12",
    "title" : "Title 3",
    "duration" : "8:48",
    "pricePerView" : "2,00"
  },
  "result" : "PAYMENT_REQUIRED"
}

Response fields

The response notifies that you have to pay.

Path Type Description

result

Result

Result of the request.

resource

Object

Describes the resource to play.
The resource object is useful to prompt the user for the payment giving him all the infos he would like.

Pays to play a not free content

$ curl 'http://platform.wim.tv:8080/api/vod/e199a7c4-e7fd-4b68-8e21-ad819ca90a6c/pay' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "advanceMonthlyPayments" : 0,
  "returnUrl" : "http://platform.wim.tv/vod/play",
  "cancelUrl" : "http://platform.wim.tv/vod/rejected",
  "embedded" : false,
  "mobile" : false
}'

Request fields

See Gets the payment parameters.

Response

HTTP/1.1 200 OK
Content-Length: 1015
Content-Type: application/json;charset=UTF-8

{
  "trackingId" : "2d0b3507-1023-445d-ad92-3c024eaa3549",
  "embedded" : false,
  "url" : "http://www.paypal.com/api/fa95ea54-5a48-4453-b4e6-c835f44e8cf1",
  "mobile" : false,
  "resource" : {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "e199a7c4-e7fd-4b68-8e21-ad819ca90a6c",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "249f39f8-f921-4c43-83cf-bff44cd70d05",
    "contentId" : "urn:wim:tv:content:fccee630-da12-4065-999a-0c28f60fcafa",
    "resourceId" : "a80a7094-e9a6-4a01-8203-8c811cedc0ea",
    "thumbnailId" : "b1e42b65-2464-4b45-8a71-353549596a12",
    "title" : "Title 3",
    "duration" : "8:48",
    "pricePerView" : "2,00"
  }
}

Response fields

See Gets the payment parameters.

Plays a content checking for the succeeded payment

$ curl 'http://platform.wim.tv:8080/api/vod/e199a7c4-e7fd-4b68-8e21-ad819ca90a6c/play' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'Content-Type: application/json' \
    -d '{
  "trackingId" : "2d0b3507-1023-445d-ad92-3c024eaa3549"
}'

Request fields

See Checking whether a payment has succeeded or not.

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2439

{
  "resource" : {
    "licenseType" : "PAY_PER_VIEW",
    "vodId" : "e199a7c4-e7fd-4b68-8e21-ad819ca90a6c",
    "publisher" : {
      "userCode" : "john",
      "licenseExpired" : false,
      "pageTitle" : "WimLabs",
      "pageDescription" : "Video Communications",
      "facebookUrl" : "http://www.facebook.com/wimlabs",
      "twitterContact" : "@wimlabs",
      "linkedinUrl" : "http://www.linkedin.com/wimlabs"
    },
    "description" : "Description 3",
    "tags" : [ "tag30", "tag31", "tag32" ],
    "boxId" : "249f39f8-f921-4c43-83cf-bff44cd70d05",
    "contentId" : "urn:wim:tv:content:fccee630-da12-4065-999a-0c28f60fcafa",
    "resourceId" : "a80a7094-e9a6-4a01-8203-8c811cedc0ea",
    "thumbnailId" : "b1e42b65-2464-4b45-8a71-353549596a12",
    "title" : "Title 3",
    "duration" : "8:48",
    "pricePerView" : "2,00"
  },
  "result" : "PLAY",
  "srcs" : [ {
    "mimeType" : "application/x-mpegurl",
    "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=73f8523d-a2a0-4e28-8813-a9abcbad4a07&streamSessionId=88db5c51-88f3-4e57-af92-ad07709d1f97&code=john&expires=1646736799509&ctrl=9d5a1e472537e08a2fbdf8bf6bbb0817277e9341c49fbe494c367091822afbd92bf88babe147a45aed6557c03b22f75b15affb9f2d0c8ce5e0450560f3643ae3",
    "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-9fad3584-a83b-4bc9-9158-37b2b9587ead-tr.mp4/playlist.m3u8?token=73f8523d-a2a0-4e28-8813-a9abcbad4a07&streamSessionId=88db5c51-88f3-4e57-af92-ad07709d1f97&code=john&expires=1646736799509&ctrl=9d5a1e472537e08a2fbdf8bf6bbb0817277e9341c49fbe494c367091822afbd92bf88babe147a45aed6557c03b22f75b15affb9f2d0c8ce5e0450560f3643ae3"
  } ],
  "mimeType" : "video/flash",
  "file" : "mp4:sample-9fad3584-a83b-4bc9-9158-37b2b9587ead-tr.mp4",
  "streamer" : "http://www.wim.tv:1935/vods3/_definst_?token=73f8523d-a2a0-4e28-8813-a9abcbad4a07&streamSessionId=88db5c51-88f3-4e57-af92-ad07709d1f97&code=john&expires=1646736799509&ctrl=9d5a1e472537e08a2fbdf8bf6bbb0817277e9341c49fbe494c367091822afbd92bf88babe147a45aed6557c03b22f75b15affb9f2d0c8ce5e0450560f3643ae3",
  "uniqueStreamer" : "http://www.wim.tv:1935/vods3/_definst_/mp4:sample-9fad3584-a83b-4bc9-9158-37b2b9587ead-tr.mp4?token=73f8523d-a2a0-4e28-8813-a9abcbad4a07&streamSessionId=88db5c51-88f3-4e57-af92-ad07709d1f97&code=john&expires=1646736799509&ctrl=9d5a1e472537e08a2fbdf8bf6bbb0817277e9341c49fbe494c367091822afbd92bf88babe147a45aed6557c03b22f75b15affb9f2d0c8ce5e0450560f3643ae3"
}

Response fields

See Plays a content.

Misc

Uploads a new thumbnail

$ curl 'http://platform.wim.tv:8080/api/thumbnail' -i -X POST \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000' \
    -H 'X-Wimtv-progressbarId: adf0928f-5c6d-4e4f-9927-fa7079c40b05' \
    -F 'thumbnail=@sample.png'

Request headers

Name Description

X-Wimtv-progressbarId

The progress bar identifier. You can query the progress bar value through by the /api/progressbar/{progressbarId} API.

* Optional.

Accept

application/json

* Required.

Request parts

Part Type Description

thumbnail

Local Path

Thumbnail to upload.

* Required.

Response

HTTP/1.1 201 Created
Content-Length: 60
Content-Type: application/json;charset=UTF-8

{
  "thumbnailId" : "13a38063-dc3d-48ec-8143-350dd199f90a"
}

Response fields

Path Type Description

thumbnailId

String

The thumbnail identifier.
You can include a thumbnail in your HTML pages through by the API /asset/thumbnail/{thumbnailId}.

Queries a progress bar

$ curl 'http://platform.wim.tv:8080/api/progressbar/0e01eb50-9610-41d4-8698-0052b0fee549' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Accept-Language: it' \
    -H 'X-Wimtv-timezone: 3600000'

Path parameters

/api/progressbar/{progressbarId}

Parameter Description

progressbarId

The progress bar identifier.

Request headers

Name Description

Accept

application/json

* Required.

Response

HTTP/1.1 200 OK
Content-Length: 17
Content-Type: application/json;charset=UTF-8

{
  "value" : 5
}
When a process has been completed, it disposes its progress bar, so any further query of the progress bar fails with HTTP status 404 (Not Found).

Response fields

Path Type Description

value

Number

Value (percentage rounded to integer).

Request requirements

Headers

Name Description

Authorization

OAuth 2.0 public or private access token.

* Required.

Accept-Language

Language to be used for localization.

* Optional.

X-Wimtv-timezone

Time-zone offset of the client (milliseconds, including DST).
For example, you can set the header with the following JavaScript expression:

-(new Date().getTimezoneOffset() * 60 * 1000);

* Optional.

Error responses

Generic errors

HTTP/1.1 404 Not Found
Content-Length: 236
Content-Type: application/json;charset=UTF-8

{
  "message" : "Il contenuto ab2ccd17-0df5-4ba6-93ee-54761ad23d05 non esiste su WimBox.",
  "error" : "Not Found",
  "timestamp" : 1646650401087,
  "status" : 404,
  "exception" : "net.cedeo.wimtv.ApplicationException",
  "path" : ""
}
Path Type Description

exception

String

Exception class.

message

String

Exception message.

status

Number

HTTP status.

error

String

HTTP status description.

path

String

API path.

timestamp

Number

Timestamp (millisecond value that is an offsetfrom the Epoch, January 1, 1970 00:00:00.000 GMT (Gregorian).

Validation errors

HTTP/1.1 400 Bad Request
Content-Length: 805
Content-Type: application/json;charset=UTF-8

{
  "objectName" : "liveEventModel",
  "globalErrors" : [ ],
  "fieldErrors" : {
    "paymentMode" : {
      "rejectedValue" : "null",
      "errors" : [ "Il tipo di licenza è obbligatorio." ]
    },
    "tags" : {
      "rejectedValue" : "[tag1, 123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890]",
      "errors" : [ "La lunghezza di ogni tag deve essere compresa tra 1 e 80 caratteri." ]
    },
    "eventDate" : {
      "rejectedValue" : "2016-10-29T13:30",
      "errors" : [ "L´ora di inizio 15:30:00 del 29/10/2016 deve precedere l´ora di fine 15:00:00 del 29/10/2016." ]
    }
  },
  "error" : "Bad Request",
  "timestamp" : 1646650401286,
  "status" : 400,
  "exception" : "org.springframework.web.bind.MethodArgumentNotValidException",
  "path" : ""
}

First of all, every request validates the object model made of the request parameters or the request payload.
If the validation fails, the exception field in the response payload is set to org.springframework.web.bind.MethodArgumentNotValidException.

Path Type Description

exception

String

Exception class.

objectName

String

Name of the object model.

globalErrors

Array of String

Array of error messages that do not concern any specific field.

fieldErrors

Map of Object

Map of objects that describes the validation errors detected for each field.

status

Number

HTTP status.

error

String

HTTP status description.

path

String

API path.

timestamp

Number

Timestamp (millisecond value that is an offsetfrom the Epoch, January 1, 1970 00:00:00.000 GMT (Gregorian).

The key of the fieldErrors map is the name of the field on which some validation error is detected.
The value of the fieldErrors map is an object with the following structure:

Path Type Description

errors

Array of String

Array of error messages detected on the field.

rejectedValue

Varies

The rejected value of the field.

Validation errors on nested object

HTTP/1.1 400 Bad Request
Content-Length: 912
Content-Type: application/json;charset=UTF-8

{
  "objectName" : "userUpdateModel",
  "globalErrors" : [ ],
  "fieldErrors" : {
    "profile.lastName" : {
      "rejectedValue" : "null",
      "errors" : [ "Il cognome è obbligatorio." ]
    },
    "profile.email" : {
      "rejectedValue" : "xxx:yyy",
      "errors" : [ "La email non è corretta." ]
    },
    "finance.companyConfirm" : {
      "rejectedValue" : "false",
      "errors" : [ "È necessario che tu abbia il diritto di rappresentare l´azienda specificata." ]
    },
    "finance.billingAddress" : {
      "rejectedValue" : "null",
      "errors" : [ "L´indirizzo di fatturazione è obbligatorio." ]
    },
    "profile.language" : {
      "rejectedValue" : "null",
      "errors" : [ "must not be blank" ]
    }
  },
  "error" : "Bad Request",
  "timestamp" : 1646650401590,
  "status" : 400,
  "exception" : "org.springframework.web.bind.MethodArgumentNotValidException",
  "path" : ""
}

If an object model contains some nested object, the key of the fieldErrors map may be the dot-separated path of fields reaching the target field.

Validation errors in multi-part requests

HTTP/1.1 500 Internal Server Error
Content-Length: 607
Content-Type: application/json;charset=UTF-8

{
  "message" : "Upload fallito (stato=ApplicationException(objectName=boxCreateModel, errors=[(defaultMessage=must not be empty, fieldName=file, rejectValue=null, codes=[validation.NotEmpty.boxCreateModel.file, validation.NotEmpty.file, validation.NotEmpty.java.lang.String, validation.NotEmpty], args=org.springframework.context.support.DefaultMessageSourceResolvable: codes [boxCreateModel.file,file]; arguments []; default message [file]])])).",
  "error" : "Internal Server Error",
  "timestamp" : 1646650400908,
  "status" : 500,
  "exception" : "net.cedeo.wimtv.ApplicationException",
  "path" : ""
}

A multi-part content can’t be read field by field unless reading the whole request stream, so the object model can be validated only after the reading of every parts and the upload of every local file.
In such cases, exception field in the response payload is set to net.cedeo.wimtv.model.validation.ValidationErrorException.

Searching for data

Query string

The request payload for all search APIs includes a Lucene query string.

The query string is reserved to the user: If a front-end developer has to search data by particular criteria, he should not use the query string with some exotic syntax; he should ask some back-end developer for enrich the search API with the needed criteria.
For example, if a user is named “dario”, a front-end developer could set “dario” to the query string and he will get all the videos uploaded by dario, but he also get the video with title “Dario The Master”, the video with description “Dario is the best programmer in the world”, and so on.
Moreover, if a front-end developer uses the query string for internal application purposes, the user does not have any tool to apply further filters to the query.

Response fields

Path Type Description

pageSize

Number

Number of item per page.

pageIndex

Number

Index of the current page.

pageCount

Number

Total number of pages.

totalCount

Number

Total number of items.

items

Array

Array of items in the current page.

Custom types

Amount

An amount is a decimal number formatted as the client locale settings state.
For example, in Italian language, the value 2500.4 is formatted as 2,500.40.

Percentage

A percentage is a decimal number formatted as the client locale settings state.
For example, in Italian language, the value 22% is formatted as 22.00.

Date

A date is formatted as the client locale settings state.
For example, in Italian language, the date October 29, 2019 is formatted as 29/10/2019.

DateTime

A time in a day is defined by a JSON object.

Path Type Description

date

String

Date component formatted as the client locale settings state.
For example, in Italian language, the date October 29, 2019 is formatted as 29/10/2019.

time

String

Time component in 24H format relative to the client time-zone settings (including DST).
For example, the time 4 PM CET may be formatted as 15:00:00.

Duration

The amount of time formatting is defined by the following rules:

  1. If the amount is less than an hour, the time format does not include the hours; for example the amount 150 seconds is formatted as 2:30.

  2. if the amount is greater than or equal to an hour, the time format includes the hours, too; for example, the amount 150 seconds is formatted as 2:30, the amount 3620 seconds is formatted as 1:00:20.

Address

An address is defined by a JSON object.

Request fields

Path Type Description

street

String

Street.

* Optional.
* Length must be between 0 and 255 inclusive.

zipCode

String

Zip code.

* Optional.
* Length must be between 0 and 10 inclusive.

city

String

City.

* Optional.
* Length must be between 0 and 50 inclusive.

state

String

State.

* Optional.
* Length must be between 0 and 50 inclusive.

country

String

Country code.

* Optional.
* Length must be between 0 and 2 inclusive.

Response fields

Path Type Description

street

String

Street.

zipCode

String

Zip code.

city

String

City.

state

String

State.

country

String

Country code.

countryName

String

Country name.

License support modes

  • EMAIL

  • PHONE

WimBox sources

Value Description

UPLOAD

Content uploaded by the owner.

MARKET_PLACE

Content acquired from Market Place.

File resource status

Value Description

READY

Ready.

PENDING

Ingestion pending.

FAILED

Ingestion failed.

Content bundle duration units

Value Description

DAYS

Days.

MONTHS

Months.

Creative Commons licenses

Value Description

BY

Attribution.

BY_SA

Attribution, share-alike.

BY_ND

Attribution, no derivatives.

BY_NC

Attribution, non commercial.

BY_NC_SA

Attribution, non commercial, share-alike.

BY_NC_ND

Attribution, non commercial, no derivatives.

WimVod licenses

Value Description

FREE

Free.

CREATIVE_COMMONS

Creative Commons.

PAY_PER_VIEW

Pay-per-view.

CONTENT_BUNDLE

Content bundle.

Market Place licenses

Value Description

FREE

Free.

CREATIVE_COMMONS

Creative Commons.

SPOT_PRICE

Spot price.

PAY_PER_VIEW

Pay-per-view.

REVENUE_SHARING

Revenue sharing.

Market Place duration units

Value Description

DAYS

Days.

MONTHS

Months.

YEARS

Years.

Live event licenses

Value Description

FREE

Free.

PAY_PER_VIEW

Pay-per-view.

WimCast program type

Value Description

PRERECORDED

A content from WimBox.

LIVE

A WimCast live stream.

WimCast program type in daily programming

Value Description

PRERECORDED

A content from WimBox.

LIVE

A WimCast live stream.

BREAK

A break.

WimCast program source type

Value Description

PRERECORDED

A content from WimBox.

LIVE

A WimCast live stream.

PROGRAM

A program scheduled in another channel in a certain day or a program scheduled in the same channel for another day.

BREAK

A break.

Demand responses

Value Description

FULFILLED

The transaction has succeeded: the transaction is free or the payment has been accepted.

PAYMENT_REQUIRED

The user has to accept a payment.

Play responses

Value Description

PLAY

You can proceed to play the content: the content is free or the payment has been accepted.

PAYMENT_REQUIRED

The user has to accept a payment in order to play the content.

SUBSCRIPTION_REQUIRED

The user has to subscribe a content bundle in order to play the content (only for WimVod items).