API Resources via Swagger
This section of the Integration Guide is focused on explaining the data model, it's elements and their relationship to each other in the context of VidiControl.
Recommended Reading
Readers are expected to be familiar with VidiCore’s own data model. This is explained in detail under the following sections of VidiCore’s documentation: VidiCore API Data Model.
Data Object Model
The VidiControl back-end is a distributed system consisting of several modules for specific tasks. These modules are responsible for planning and executing bookings, communicating with the Vidispine suite and interacting with third-party systems.
Jobs
This section describes the objects related to a job. From a user’s perspective, a job is represented as a BookingDefinition. Jobs can be recording jobs, router switch jobs, etc.
Resources
Resources are responsible for performing a command. Some examples of resources are for instance a recorder or a router. Resources are booked to perform a job. To perform a recording job, several (optional) resource devices have to be controlled: A source device to deliver a signal, a router device to switch, a recording device to record.
The system manages atomic resources as devices.
Services
VidiControl offers service APIs to request data to recordings and devices. New recordings can be scheduled with the BookingService, resources can be monitored with the ResourceService.
A SWAGGER page contains the mentioned services. For more details, please see API Resources via Swagger .
Action Service
The Action Service can be used to view and resolve actions.
Booking Service
The Booking Service is used to inspect, monitor, modify, create and delete BookingDefinitions and its subordinated objects (like Bookings, Recurrences and Chunks).
Configuration Service
The Configuration Service allows the user to request and modify the backend config values. Besides that, it can also be used to request, change and delete event types.
Resource Service
With the Resource Service, resources like pools, devices, router ports, routings and capabilities and their assignments can be requested, created, updated and deleted.
Notification Queue
There is an ActiveMQ notification topic where you can connect as a consumer.