Page History

...

• The JOC Cockpit REST Web Service provides the API for the JOC Cockpit user interface.
  • The JOC Cockpit REST Web Service  API is not considered stable as it API is might change along minor releases with the requirements of future JOC Cockpit development.
  • The JOC Cockpit REST Web Service comes in addition to the JobScheduler REST Web Service that is considered a stable API and as a replacement for the retired XML Interface.
• The REST Web Service is used by the JOC Cockpit and by external applications for  for interaction with a JobScheduler Master:
  • The Access to the REST Web Service offers access to objects such as jobs, job chains and orders and their respective operations, e.g. to add an order to a job chain.
  • Access to the REST Web Service is restricted by permissions, see Authentication and Authorization - Permissions for the JOC Cockpit Web Service

References

• • is restricted by permissions, see Authentication and Authorization - Permissions for the JOC Cockpit Web Service

Usage

• The REST Web Service is called by using an HTTP client.
• The following REST Web Service requests are supported:
  • URL joc/api/security/login
    • The first operation of a client should be call to this URL in order to authenticate and to retrieve an access token.
    • A valid account and password have to be provided by the client for HTTP authentication. The account and permissions for the command(s) to be executed are configured with the shiro.ini configuration file. See the Authentication and Authorization - Configuration article and the example api_user configuration for further information.
    • Use the joc/api/security/joc_cockpit_permissions URL to retrieve the permissions for the current user.
  • URL  joc/api/* 
    
    • Subsequent calls to URLs can retrieve the job inventory and current information about jobs and job chains.
    • The JOC Cockpit REST Web Service will return the respective JSON response.
  • URL joc/api/security/logout
    • The last operation of a client should be a call to this URL in order to logout from the web service.
• Requirements
  • All REST Web Service requests should use an HTTP POST operation.
  • Should an idle timeout of 15 minutes between two web service requests be exceeded then the current session is invalidated and a login has to be performed.

Specification

• The specification is available from http://test.sos-berlin.com/JOC/raml-doc/JOC-API and includes the RAML specification.

References

• Authentication and Authorization: Permissions for the JOC Cockpit Web Service
• Specification JOC Cockpit REST Web Services Technical Documentation (RAML Specification)

 /index.html