OASYS | Rest
OASYS REST Restful API delivers the most effective strategy to expose MultiValue data and business rules to any external application consumer requiring access to MultiValue database assets. Coupled with advanced web and mobile development technologies, developers can be more productive by extending existing applications and/or build new applications by leveraging the most current technology available in the market.
OASYS REST offers MultiValue multi-platform support, a scalable, secure and high performance gateway, interfaces to access MultiValue data, invoke subroutines, execute queries and reports, wrap any program, execute commands and much more. Built in examples are included to get you started!
OASYS REST was built to enable collaboration between multi-discipline development teams. For instance, the front end or integration development team can access data and invoke MultiValue business rules in standard JSON notation, while MultiValue Developers can service enable core functionality and MultiValue data with ease.
Quick overview
To invoke a service use:
http{s}://{your domain}/mvrest/api/{my server}/{service name}/{{service param}/?
Most services will require an authentication token. A token is provided after running the login service which will be used for validating any subsequent request during a session. Our JSON implementation supports unlimited nesting levels and incoming JSON data can be mapped to a MV record for ease consumption by MV Developers.
When invoking any OASYS MVRest service, developers can expect a standard JSON output response. Below are a few modes of this request/response interaction.
OASYS REST API has built in smart server request extensions supporting multiple variations for data retrieval. Effectively, fields can be referenced directly by dictionary or by associations as well as “soft grouping” data fields. This technique yields on the fly normalization capabilities without modifying MultiValue data.
fields=[(group name);mvfield1;mvfield2;..];field1
Below is a list of out if the box OASYS REST service API function groups that will help development efforts started immediately.
Mode 1
[
{
"field1": "record 1 data 1",
"field2": "record 1 data 2",
"field3": "record 1 data 3"
},
{
"field1": "record 2 data 1",
"field2": "record 2 data 2",
"field3": "record 2 data 3"
},
]
Mode 2
[
[
"record 1 data 1",
"record 1 data 2"
"record 1 data 3"
],
[
"record 2 data 1",
"record 2 data 2"
"record 2 data 3"
]
]
JSON output modes
Security: Security Services used for server authentications, token generation, connecting and disconnecting from the database server
System: System Services to determine system version, invoke queries, execute TCL commands, compile basic programs or any other system function available.
Basic Calls: Basic Subroutine Call Services to invoke backend subroutines that can return data in raw MV format or JSON notation depending on your requirements.
CRUD: CRUD operations on MultiValue data files using standard interfaces such as POST, GET, PUT and DELETE, allows direct access to MultiValue database operations for single record, target attribute access and honoring MultiValue data structures.
What can I do with Oasys MVRest?
Create Bootstrap responsive forms that run on any device (web, tablets, mobile regardless of platform).
Integrate easily with web applications, eCommerce sites or external applications that support Restful services.
Create customized dashboards with graphs and charts for reporting and monitoring.
Create integration access points to MultiValue data as single records or “normalized” views.
Call any Basic subroutine and return output on standard JSON format.
Consume any JSON input and transform to MV raw data.
Convert MV to JSON and JSON to MV messages.
Wrap any existing MultiValue Business rules and transform it into a Restful service with full I/O control on request/response interaction.
Perform any CRUD operation to MVData from an external application.
Any OASYS REST service request can target an authorized account without the need of logging to the account.
Securely create, edit, compile and catalog BASIC programs from any browser with Onsystex’s built in Web editor.
Create and manage your own library of custom APIs with Swagger, Postman and others.
Deploy OASYS REST services to the cloud securely for greater scalability.
Enable your MultiValue environment with a small footprint installation.
Remote access any supported MultiValue Databases and perform operations remotely.
Use standard free open source tools to test your Restful services.