POST api/WidevineDataSets

Creates a new Widevine data set.

Request Information

URI Parameters

None.

Body Parameters

Data to use for the new data set.

NewWidevineDataSet
NameDescriptionTypeAdditional information
Name

The name of the data set.

string

Max length: 256

Min length: 1

ServiceCertificate

The Widevine service certificate in the binary format as provided to you by Google. Duplicate entries with the same service certificate are not allowed.

Collection of byte

Required

ProtectedPrivateKey

The private key associated with the provided service certificate. It must be password-protected and in the PCKS#8 DER format as specified by Google's certificate generation instructions.

Collection of byte

Required

PrivateKeyPassphrase

The passphrase the private key is protected with. It must be a UTF-8 string.

string

Required

Max length: 256

Min length: 1

IsDefault

Indicates whether the certificate must be treated as the default one. In case of multiple certificates, the certificate that is made default the latest will be returned.

boolean

None.

Request Formats

application/json, text/json

Sample:
{
  "Name": "sample string 1",
  "ServiceCertificate": "QEA=",
  "ProtectedPrivateKey": "QEA=",
  "PrivateKeyPassphrase": "sample string 2",
  "IsDefault": true
}

Response Information

Resource Description

WidevineDataSet
NameDescriptionTypeAdditional information
Id

The ID of the data set.

globally unique identifier

Required

Name

The name of the data set.

string

None.

ServiceCertificateSerial

The serial number of the service certificate.

Collection of byte

Required

Max length: 256

Min length: 1

Created

The date when the data set was created (in the ISO 8601 format).

date

Required

Updated

The date when the Widevine data set was updated last time (in the ISO 8601 format).

date

None.

MadeDefault

The date when the Widevine data set was made as the default one (in the ISO 8601 format). There may be multiple key seeds that were made as the default ones, but only one key seed will be treated as the default one. The default key seed is the last key seed that was made as the default one. If no key seeds were ever made as the default ones, the oldest key seed will be treated as the default one.

date

None.

Status Codes

All HTTP status codes must be expected, but the following status codes are the most probable:

  • Created (201) - The data set is successfully added.
  • BadRequest (400) - The data for a new data set is invalid.

Response Formats

application/json, text/json

Sample:
{
  "Id": "58f2cf80-ed0c-42ae-898d-7c39c5bef44a",
  "Name": "sample string 2",
  "ServiceCertificateSerial": "QEA=",
  "Created": "2024-09-11T10:50:54.574054+00:00",
  "Updated": "2024-09-11T10:50:54.574054+00:00",
  "MadeDefault": "2024-09-11T10:50:54.574054+00:00"
}