-
Type: Task
-
Status: Closed
-
Priority: Major
-
Resolution: Fixed
-
Component/s: OASIS Open Repository
-
Labels:None
-
Environment:
OData
Submitted on Saturday, June 11, 2016 - 00:44
Submitted by user:
Submitted values are:
Your name: Ram Jeyaraman
TC name: OASIS OData Technical Committee
TC email address: odata@lists.oasis-open.org
GitHub name: odata-openapi
Purpose statement:
OData (Open Data Protocol) is an OASIS standard that defines best practices
for
building and consuming RESTful APIs. OData helps you focus on your business
logic while building RESTful APIs without having to worry about the
approaches
to define request and response headers, status codes, HTTP methods, URL
conventions, media types, payload formats and query options etc. OData also
guides you about tracking changes, defining functions/actions for reusable
procedures and sending asynchronous/batch requests etc. Additionally, OData
provides facility for extension to fulfill any custom needs of your RESTful
APIs.
OData RESTful APIs are easy to consume. The OData metadata, a
machine-readable
description of the data model of the APIs, enables the creation of powerful
generic client proxies and tools. Some of them can help you interact with
OData
even without knowing anything about the protocol.
OData RESTful APIs are even easier to consume if they provide an API
description
based on the OpenAPI Specification, enabling the use of OpenAPI tools.
This repository provides tools for producing OpenAPI descriptions for OData
services.
Description: Tools for producing API descriptions for OData services that
adhere
to the OpenAPI Specification.
Open source license: Apache License v 2.0
Maintainer(s):
Ralf Handl, ralf.handl@sap.com, ralfhandl, SAP SE
Mike Pizzo, mikep@microsoft.com, mikepizzo, Microsoft
Approval link:
https://www.oasis-open.org/apps/org/workgroup/odata/download.php/58307/odata-meeting-132_on-20160602-minutes.html
Notes:
Planned work items:
XSLT transformation from OData CSDL XML to OpenAPI JSON
example XML files
example openapi.json files
example files for the live odata.org services
The results of this submission may be viewed at:
http://tools.oasis-open.org/issues/browse/TCADMIN