MagicINFO Server allows you to implement content management, schedule management, device management, and such by calling Open API (v2.0).
To use Open API (v2.0), you will first need to go through an authentication process. Use a separate swagger page to test each API.
Authentication
When calling all Open API (v2.0) items, api_token must be included in the header. If this is not included, a "401 Unauthorized." error is returned.
An obtained token expires and becomes unavailable for use after a specified period of time. If this is the case, you should obtain a new token.
api_token can be obtained by calling the following api.
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| POST | Imports a token value for authentication using the user ID and password. |
|
| GET | Creates a new token to extend the expire time. It is possible to call REST API without logging in again |
OPEN API (v2.0)
MagicINFO Server Open API (v2.0) provides a variety of functions. Configuration of each function is shown below.
Category | Controller | Description |
|---|---|---|
Content |
| Content file management |
| Content group management | |
Playlist |
| Managing Playlists |
| Playlist group management | |
Schedule |
| Content schedule management |
| Content schedule group management | |
| Managing Message Schedules | |
| Message schedule group management | |
Device |
| Device management |
| Device group management | |
User |
| User management |
| User group management | |
Setting |
| Setting |
Content
Upload, approve, or delete content. Manage content lists. Content-related services are accessible to authenticated users with privileges to read, write, and manage content.
Available content management services are as follows:
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| GET | Imports a list of uploaded content. Content thumbnails, names, file types, and other basic information are included in the list. Lists can be imported per page, using paging information. |
|
| GET | Imports general content information to be displayed on the dashboard. |
|
| POST | Imports a list of content filtered based on conditions. Lists can be imported per page, using paging information. |
|
| DELETE | Deletes content, whether or not the content is included in a playlist or schedule. |
|
| DELETE | Deletes content after checking that the content is not included in a playlist or schedule. If attempting to delete content included in a playlist or schedule, the content will not be deleted and an error code will be returned. |
|
| GET | Whenever content is modified, its version is updated. The active version of content details is fetched. |
|
| PUT | Approves/rejects content. Approved content is moved to the general content list and can be used in playlists or schedules. |
|
| POST | Uploads new content. |
|
| GET | Imports a list of default content groups. |
|
| GET | Fetches details of the |
|
| GET | Fetches a list of sub groups under the |
Playlist
Use content to create, edit, or delete playlists. Playlist-related services are accessible to authenticated users with privileges to read, write, and manage content.
Available playlist management services are as follows:
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| GET | Imports a list of all playlists. Playlist names, main content thumbnails, playlist types, and other basic information are included in the list. Lists can be imported per page, using paging information. |
|
| POST | Creates a new playlist. |
|
| GET | Imports necessary playlist information from the dashboard. |
|
| POST | Imports a list of playlists filtered based on conditions. Lists can be imported per page, using paging information. |
|
| DELETE | Deletes the selected playlist. If attempting to delete a playlist included in a schedule, the playlist will not be deleted and an error code will be returned. |
|
| GET | Imports details of an activated version of a playlist. The version of a playlist is updated each time the playlist is edited. |
|
| PUT | Modifies the |
|
| PUT | Copies the |
|
| GET | Imports a list of default playlist groups. |
|
| GET | Fetches details of the |
| /restapi/v1.0/cms/playlists/groups/{groupId}/child | GET | Fetches a list of sub groups under the |
Schedule
Create new content or message schedules. Publish schedules to devices for playback. Edit or delete schedules.
Schedule-related services are accessible to authenticated users with privileges to read, write, and manage schedules.
Available schedule management services are as follows:
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| GET | Imports a list of all content schedules. Content schedule names, dates of creation, device types, and other basic information are included in the list. Lists can be imported per page, using paging information. |
|
| POST | Creates a new content schedule. A content schedule may contain multiple channels and frames. Publish a schedule to devices and play the desired content or playlist at a specified time. |
|
| GET | Imports necessary content schedule information from the dashboard. |
|
| POST | Imports a list of content schedules filtered based on different conditions. Lists can be imported per page, using paging information. |
|
| DELETE | Deletes a content schedule. If deleting a schedule previously published to a device, the device automatically plays the default content. |
|
| GET | Imports details of the selected schedule. |
|
| PUT | Edits a content schedule. If editing a schedule previously published to a device, the device automatically plays the edited schedule. |
|
| PUT | Copies the |
|
| PUT | Publishes a content schedule to a specific device group. |
|
| GET | Imports real-time content schedule download status from a device. |
|
| GET | Imports a list of root groups for a content schedule. |
| /restapi/v1.0/dms/schedule/contents/groups/{groupId} | GET | Fetches details of the |
|
| GET | Imports a list of all message schedules. |
|
| POST | Creates a new message schedule. |
|
| POST | Imports a list of message schedules filtered based on different conditions. Lists can be imported per page, using paging information. |
|
| DELETE | Deletes the selected message schedule. If deleting a message schedule previously published to a device, the change is automatically applied to the device. |
|
| GET | Imports details of the selected message schedule. |
|
| PUT | Edits the selected message schedule. If editing a message schedule previously published to a device, the change is automatically applied to the device. |
|
| PUT | Copies the selected message schedule. A duplicate copy of the message schedule is created. |
|
| PUT | Publishes the selected message schedule to a device group. |
|
| GET | Imports a list of root groups for a content schedule. |
|
| GET | Fetches details of the |
|
| GET | Imports a list of sub-groups under a specific group. |
Device
Control and manage devices. Device-related services are accessible to authenticated users with privileges to read, write, and manage devices.
Available device management services are as follows:
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| GET | Imports a list of all devices. Device power status, thumbnail info, device error status, and other basic information are included in the list. Lists can be imported per page, using paging information. |
|
| GET | Imports necessary device information from the dashboard. |
|
| POST | Imports a list of devices filtered based on different conditions. Lists can be imported per page, using paging information. |
|
| DELETE | Deletes the selected device. |
|
| GET | Imports details of the selected device. |
|
| PUT | Approves the selected device to a specific group. |
|
| POST | Imports information about cabinets connected to an LED device. The imported information is valid only when the cabinets are connected to an LED device. |
|
| PUT | Edits information about cabinets connected to an LED device. |
|
| GET | Imports device display control information from the database. If control information is not present, an information request should be sent to the device. |
|
| PUT | Sends edited display control information to a device. Only edited values in display information are sent as a protocol to the device. |
|
| GET | Receives edited display control information from a device. This API is run after executing the |
|
| GET | Imports general device information from the database. General device information is updated when the device connects to the server. |
|
| PUT | Sends edited device information to a device. Only edited values in basic device information are sent as a protocol to the device. |
|
| GET | Receives edited device information from a device. This API is run after executing the |
|
| PUT | Moves a device to another group. |
|
| GET | Sends an RM start protocol to a device. A device that received an RM start protocol sends information periodically via the Remote control Server. |
|
| GET | Sends an RM stop protocol to a device. A device that received a stop protocol stops the corresponding function immediately. |
|
| GET | Imports device settings. Device settings are updated when the device connects to the server. |
|
| PUT | Sends edited device settings to a device. Only edited values in settings are sent as a protocol to the device. |
|
| GET | Receives edited device settings from a device. This API is run after executing the |
|
| GET | Sends a current display control information request to a device. When calling this API, |
|
| GET | Imports display control information sent from a device. This option is used for two actions: sending a request for information to a device and receiving actual device information. |
|
| GET | Sends a current time information request to a device. When calling this API, requestId is returned as the response value. |
|
| GET | Imports time information sent from a device. |
|
| GET | Imports device time information from the database. If control information is not present, an information request should be sent to the device. |
|
| PUT | Sends edited time information to a device. Only edited values in time information are sent as a protocol to the device. |
|
| GET | Receives edited device time information from a device. This API is run after executing the |
|
| GET | Imports a list of organizations. |
|
| GET | Fetches details of the |
|
| GET | Fetches sub groups under |
User
Add users and manage user information. User-related services are accessible to authenticated users with privileges to read, write, and manage user information.
Available user management services are as follows:
Service Name | API call | Call Type | Description |
|---|---|---|---|
| /restapi/v1.0/ums/users | POST | Adds a user. |
|
| GET | Imports necessary user information from the dashboard. |
|
| PUT | Edits user information. |
|
| GET | Imports a list of organizations. This option can be used to configure a group tree. |
|
| GET | Imports a list of organizations. |
|
| GET | Fetches details of the |
|
| GET | Fetches a list of sub groups under the |
Setting
In addition to main functions, you can use many other functions to create and manage tags and categories, and edit the dashboard.
Service Name | API call | Call Type | Description |
|---|---|---|---|
|
| GET | Imports a list of categories. |
|
| DELETE | Deletes specific dashboard information. |
|
| GET | Imports content to be displayed on the customized dashboard. It is possible to display only specific information on the dashboard. |
|
| PUT | Changes the order of items displayed on the dashboard. |
|
| GET | Activates an idle dashboard. |
|
| GET | Imports login information to be displayed on the dashboard. |
|
| GET | Imports bulletin board information to be displayed on the dashboard. |
|
| DELETE | Deletes a post from the bulletin board. |
|
| GET | Imports details of the selected post. |
|
| POST | Adds posts to the bulletin board. |
|
| PUT | Edits the selected post on the bulletin board. |
|
| GET | Imports storage information to be displayed on the dashboard. |
|
| GET | Imports a list of licenses registered on the server. |
|
| GET | Imports server settings. Server setting items include options that can turn on or off different functions on the server. |
|
| POST | Imports a list of tags registered on the server. |