NovaCloud-EN
  1. Solutions
NovaCloud-EN
  • API Access Guide
  • Common HTTP Status Codes
  • VNNOX
    • Player
      • Player Management
        • Obtain player list
      • Obtaining Player Status
        • Obtaining Basic Player Information
        • Obtaining Player Configuration Status
    • Solutions
      • Emergency Insertion
        • Single-Page Emergency Insertion Solutions
        • Canceling Emergency Insertion Solutions
      • Program widget examples
        • Hand-drawn clock widget
        • Weather widget
        • Environmental Monitoring widget
      • Common Solutions
        POST
      • Offline Export
        POST
      • Over-specification Detection Switching
        POST
      • Program Over-specification Detection
        POST
    • Real-Time Control
      • NTP Time Synchronization
      • Synchronous playback
      • Brightness Adjustment
      • Screenshots
      • Volume Adjustment
      • Video Source Switching
      • Screen Status
      • Restart Players
      • Screen Power
    • Scheduled Control
      • Scheduled Screen Status
      • Scheduled Restart Players
      • Scheduled Volume Adjustment
      • Scheduled Brightness Adjustment
      • Scheduled Video Source Switching
    • Logs
      • Play Logs
        • Batch Searching for Play Log Overviews
        • Batch Searching for Play Log Details
        • Searching for the Play Log Detail of a Single Player
        • Searching for the Play Log Overview of a Single Player
      • Obtaining Control Command Execution Logs
    • Notifications
      • Video Source Change Notifications
      • Solution Change Notifications
  • VNNOXCare
    • Notes
    • Device Status Monitoring
      • Receiving Card
        • Topology Information
        • Basic Information
        • Monitoring Information
        • Alarm Information
      • Screen
        • Screen list
        • Screen detail
        • Monitoring Information
      • Master Controller
        • Basic Information
        • Alarm Information
        • Operating Parameters Information
      • Smart Module
        • Monitoring Information
        • Alarm Infomation
      • Input Source
        • Monitor Infomation
      • Module/Cabinet
        • Monitoring Information
      • Monitoring Card
        • Monitoring Information
      • Camera
        • Camera configuration
        • The camera monitors the aggregated information
    • Brightness Log
      • Brightness History
  • Others
    • Third-Party System Authorization
      • Obtaining User List
      • Obtaining Login URL
  1. Solutions

Common Solutions

US
https://open-us.vnnox.com
US
https://open-us.vnnox.com
POST
/v2/player/program/normal
TIP
1.
This interface is used for making solutions and publishing them to players.
2.
Taurus later than V2.0.0 are supported.
3.
Sub-accounts can only manage data within their specific workgroup and its sub-workgroups.
4.
Advanced interface.
💡
The widgets field supports polymorphic structures - its schema varies depending on the type value. Standard widgets are already included, for extended types, see:
Hand-drawn clock widget
Weather widget
Environmental Monitoring widget

Request

Body Params application/json

Example
{
    "playerIds": [
        "553cbfe2ff4ad2e0d6bd89bb2c4e85e2"
    ],
    "schedule": {
        "startDate": "2020-04-11",
        "endDate": "2060-05-12",
        "plans": [
            {
                "weekDays": [
                    1,
                    2,
                    3,
                    4,
                    5
                ],
                "startTime": "00:00:00",
                "endTime": "22:00:00"
            },
            {
                "weekDays": [
                    0,
                    6
                ],
                "startTime": "00:33:00",
                "endTime": "22:00:00"
            }
        ]
    },
    "pages": [
        {
            "name": "a-page",
            "widgets": [
                {
                    "zIndex": 1,
                    "type": "PICTURE",
                    "size": 25943,
                    "md5": "8330dcaa949ceeafa54a66e8ad623300",
                    "duration": 10000,
                    "url": "http://vnnox-public.oss-cn-qingdao.aliyuncs.com/myf/test.jpg",
                    "layout": {
                        "x": "0%",
                        "y": "0%",
                        "width": "100%",
                        "height": "100%"
                    },
                    "inAnimation": {
                        "type": "NONE",
                        "duration": 1000
                    }
                },
                {
                    "zIndex": 2,
                    "type": "VIDEO",
                    "size": 1227710,
                    "md5": "f5b0f315800cb4befb89b5dff42f1e34",
                    "duration": 0,
                    "url": "http://vnnox-public.oss-cn-qingdao.aliyuncs.com/myf/nova2019.mp4",
                    "layout": {
                        "x": "0%",
                        "y": "20%",
                        "width": "20%",
                        "height": "20%"
                    }
                }
            ]
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-us.vnnox.com/v2/player/program/normal' \
--header 'Content-Type: application/json' \
--data-raw '{
    "playerIds": [
        "553cbfe2ff4ad2e0d6bd89bb2c4e85e2"
    ],
    "schedule": {
        "startDate": "2020-04-11",
        "endDate": "2060-05-12",
        "plans": [
            {
                "weekDays": [
                    1,
                    2,
                    3,
                    4,
                    5
                ],
                "startTime": "00:00:00",
                "endTime": "22:00:00"
            },
            {
                "weekDays": [
                    0,
                    6
                ],
                "startTime": "00:33:00",
                "endTime": "22:00:00"
            }
        ]
    },
    "pages": [
        {
            "name": "a-page",
            "widgets": [
                {
                    "zIndex": 1,
                    "type": "PICTURE",
                    "size": 25943,
                    "md5": "8330dcaa949ceeafa54a66e8ad623300",
                    "duration": 10000,
                    "url": "http://vnnox-public.oss-cn-qingdao.aliyuncs.com/myf/test.jpg",
                    "layout": {
                        "x": "0%",
                        "y": "0%",
                        "width": "100%",
                        "height": "100%"
                    },
                    "inAnimation": {
                        "type": "NONE",
                        "duration": 1000
                    }
                },
                {
                    "zIndex": 2,
                    "type": "VIDEO",
                    "size": 1227710,
                    "md5": "f5b0f315800cb4befb89b5dff42f1e34",
                    "duration": 0,
                    "url": "http://vnnox-public.oss-cn-qingdao.aliyuncs.com/myf/nova2019.mp4",
                    "layout": {
                        "x": "0%",
                        "y": "20%",
                        "width": "20%",
                        "height": "20%"
                    }
                }
            ]
        }
    ]
}'

Responses

🟢200OK
application/json
Body

Example
{
    "success": [
        "8cd86b94c6617c5d771fb91224b45685"
    ],
    "fail": []
}
Modified at 2025-05-21 09:52:00
Previous
Environmental Monitoring widget
Next
Offline Export
Built with