...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
GET /v1/info/
Returns basic player information
Request Example
| Code Block |
|---|
GET /api/v1/info/ HTTP/1.1
Host: {{playerIP}
Authorization: {{DigestAuth}} |
Response Body
serialstring: The serial number of the playermodelstring: The model number of the device (e.g. "XD234")connectionTypestring: The currently active network interface, which can be either "Ethernet" or "WiFi"ethernetobject: An object containing information about the ethernet connection. This property will only be available if there's a valid ethernet connection on the player. The object can contain the following properties:IPv4object: An object containing information about the IPv4 configuration. The object can contain the following properties:addressstring: The assigned IPv4 addressnetmaskstring: The IPv4 network maskfamilystring:IPv4macstring: The MAC address of the network interfaceinternalbool:trueif the network interface is a loopback or similar interface that is not remotely accessible; otherwisefalsecidrstring: The assigned IPv4 address with the routing prefix in CIDR notation. If thenetmaskis invalid, this property is set tonull.
IPv6object: An object containing information about the IPv6 configuration:addressstring: The assigned IPv6 addressnetmaskstring: The IPv6 network maskfamilystring:IPv6macstring: The MAC address of the network interfaceinternalbool:trueif the network interface is a loopback or similar interface that is not remotely accessible; otherwisefalsecidrstring: The assigned IPv6 address with the routing prefix in CIDR notation. If thenetmaskis invalid, this property is set tonull.
bootVersionstring: The current version of the boot loaderfwVersionstring: The current version of firmware installed on the playerupTimestring: The amount of time (as a human-readable string) that the player has been powered on and working correctlyupTimeSecondsint: The amount of time (in seconds) that the player has been powered on and working correctlyextensionsextension[ ]: An array of Extension objects describing Firmware Extensions currently installed on the playerblessingsblessing[ ]: An array of Blessing objects describing proprietary codecs that are currently authorized on the player
Response Example
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
...
Endpoints:
...
GET /v1/time/
Retrieves the date and time as configured on the player. The date/time value is formatted as "yyyy-mm-dd hh:mm:ss <timezone>".
Request Example
| Code Block |
|---|
GET /api/v1/time/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}} |
Response Example
| Code Block | ||
|---|---|---|
| ||
{
"route": "/v1/time",
"method": "GET",
"data": {
"result": {
"time": "2018-10-18 14:34:34 PDT",
"timezone_mins": null,
"timezone_name": "America/Los_Angeles",
"timezone_abbr": "PDT",
"year": 2018,
"month": 10,
"date": 18,
"hour": 14,
"minute": 34,
"second": 34,
"millisecond": 569
}
}
}
|
PUT /v1/time/
Sets the time on the player.
Request Body
datestring: The recommended format is: "YYYY-MM-DD"timestring: The recommended format is: "HH:mm"applyTimezonebool: This value decides if the date and time passed is in UTC or not (the default is false).
Request Example
| Code Block |
|---|
PUT /api/v1/time/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
Content-Type: application/json
Content-Length: 117 |
This is the example request body:
| Code Block | ||
|---|---|---|
| ||
{
"data": {
"time": "22:00:00",
"date": "2023-11-07",
"applyTimezone": true
}
} |
Response Example
| Code Block | ||
|---|---|---|
| ||
{
"data": {
"result": true
}
} |
GET /v1/video-mode/
Returns the current video mode of the player
Request Example
| Code Block |
|---|
GET /api/v1/video-mode/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}} |
Response Body
widthint: The screen widthheightint: The screen heightframesint: The frame ratescanstring: The scan method of the video signal, which can be either progressive ("p") or interlaced ("i")namestring: The full name of the video mode (a full list of modes can be found here)isAutoModebool: A flag indicating whether the video mode was set using auto modemodemode{ }: A Mode object that gives additional information about the video output. This object can contain the following properties:preferredbool: A flag indicating whether the video mode is the preferred modeoverscanbool: A flag indicating whether the video output is using an overscan setting or notmodeNamestring: The full name of the video mode (a full list of modes can be found here)interlacedbool: A flag indicating whether the video output is interlaced (true) or progressive (false)widthint: The width of the video outputheightint: The height of the video outputgraphicsPlaneWidthint: The width of the graphics planegraphicsPlaneHeightint: The height of the graphics planefrequencyint: The frame rate of the video outputdropFramebool: A flag indicating whether the video timecode utilizes drop framescolorSpacestring: The color space of the video signal ("rgb", "yuv420", or "yuv422")colorDepthstring: The color depth of the video signal ("8bit", "10bit", or "12bit")
Response Example
| Code Block | ||
|---|---|---|
| ||
{
"route": "/v1/video-mode",
"method": "GET",
"data": {
"result": {
"isAutoMode": false,
"name": "640x480x60p",
"width": "640",
"height": "480",
"frames": "60",
"scan": "p",
"mode": {
"colorDepth": "8bit",
"colorSpace": "rgb",
"dropFrame": false,
"frequency": 60,
"graphicsPlaneHeight": 480,
"graphicsPlaneWidth": 640,
"height": 480,
"interlaced": false,
"modeName": "640x480x60p",
"overscan": false,
"preferred": false,
"width": 640
}
}
}
}
|