REST
Applies to: Kyvos Enterprise Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace
Kyvos Azure Marketplace  Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)
RESTÂ integration architectureÂ
The following figure illustrates REST integration architecture.Â
The architecture consists of the following components.Â
Host Application: Any application capable of sending REST requests to the Kyvos application.Â
Kyvos Cluster: One or more computers on which Kyvos software is running. Generally, this cluster is deployed on Hadoop cluster computers. One of these computers deploys the Kyvos web application, which acts as a communication point for the REST APIs. You may need the web application URL to use the APIs.Â
APIs: The APIs provide REST services to list, create, update, and delete cubes and other repository items. This also invokes Kyvos actions, such as starting a cube build. Responses are given in the form of XMLs.Â
REST APIsÂ
In the case of Java-based REST client (host application), to parse the XML and populate Java beans, include the following jar files in the classpath of the host application.Â
json-simple-1.1.1.jarÂ
kyvosclient.jarÂ
kyvoscommons.jarÂ
log4j-1.2.14.jarÂ
xercesImpl-2.9.1.jarÂ
xmlParserAPIs-2.6.2.jarÂ
The Kyvos installer contains these files at the <Kyvos_Web_App_path>\WEB-INF\lib location.Â
Response codeÂ
The Kyvos API attempts to return appropriate status codes for every request.Â
Kyvos API response codesÂ
Response Code | Response Message |
200Â | OKÂ |
503 | TIMEOUT OCCURRED. LOGIN AGAIN. |
401Â | UNAUTHORIZED ACCESSÂ |
404Â | RECORD NOT FOUNDÂ |
412Â | PRECONDITION FAILED. PARAMETER MISSINGÂ |
500Â | FAILEDÂ |
REST APIs Reference Guide
Copyright Kyvos, Inc. All rights reserved.