You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The goal of Swagger™ is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined via Swagger, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interfaces have done for lower-level programming, Swagger removes the guesswork in calling the service.
7
+
The goal of The OpenAPI Specification is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interfaces have done for lower-level programming, OpenAPI removes the guesswork in calling the service.
9
8
10
-
Use cases for machine-readable API interfaces include interactive documentation, code generation for documentation, client, and server, as well as automated test cases. Swagger-enabled APIs expose JSON files that correctly adhere to the Swagger Specification, documented in this repository. These files can either be produced and served statically, or be generated dynamically from your application.
9
+
Use cases for machine-readable API interfaces include interactive documentation, code generation for documentation, client, and server, as well as automated test cases. OpenAPI-enabled APIs expose JSON files that correctly adhere to the OpenAPI Specification, documented in this repository. These files can either be produced and served statically, or be generated dynamically from your application.
11
10
12
11
Without going into a long history of interfaces to Web Services, this is not the first attempt to do so. We can learn from CORBA, WSDL and WADL. These specifications had good intentions but were limited by proprietary vendor-specific implementations, being bound to a specific programming language, and goals which were too open-ended. In the end, they failed to gain traction.
13
12
14
-
Swagger does not require you to rewrite your existing API. It does not require binding any software to a service--the service being described may not even be yours. It does, however, require the capabilities of the service be described in the structure of the Swagger Specification. Not all services can be described by Swagger--this specification is not intended to cover every possible use-case of a REST-ful API. Swagger does not define a specific development process such as design-first or code-first. It does facilitate either technique by establishing clear interactions with a REST API.
13
+
OpenAPI does not require you to rewrite your existing API. It does not require binding any software to a service--the service being described may not even be yours. It does, however, require the capabilities of the service be described in the structure of the OpenAPI Specification. Not all services can be described by OpenAPI--this specification is not intended to cover every possible use-case of a REST-ful API. OpenAPI does not define a specific development process such as design-first or code-first. It does facilitate either technique by establishing clear interactions with a REST API.
15
14
16
-
This GitHub project is the starting point for Swagger.
17
-
Here you will find the information you need about the Swagger Specification, a simple static sample of what it looks like,
15
+
This GitHub project is the starting point for OpenAPI.
16
+
Here you will find the information you need about the OpenAPI Specification, a simple static sample of what it looks like,
18
17
and some general information regarding the project.
19
18
20
19
21
20
## Current Version - 2.0
22
21
23
-
The current version of the Swagger specification is 2.0 - and you can find it [here](versions/2.0.md).
22
+
The current version of the OpenAPI specification is 2.0 - and you can find it [here](versions/2.0.md).
24
23
25
-
### [Swagger 2.0 Specification](versions/2.0.md)
24
+
### [OpenAPI 2.0 Specification](versions/2.0.md)
26
25
27
26
This repository contains the existing Swagger 1.2 specification as well as proposals for the 2.0 version.
28
27
29
28
## Structure
30
29
31
30
Each section should contain v1.2 and v2.0 folders to avoid confusion between the versions.
32
31
33
-
Please keep in mind that the other projects under Swagger use an independent version system.
34
-
As such, don't confuse the version of the Swagger Specification they support and the version of that given library.
35
-
For example, Swagger-Core with the version 1.3.2 supports Swagger Specification 1.2.
32
+
Please keep in mind that the other projects under OpenAPI use an independent version system.
33
+
As such, don't confuse the version of the OpenAPI Specification they support and the version of that given library.
36
34
37
35
## The Wiki
38
36
39
-
Check out the [wiki](https://github.com/swagger-api/swagger-spec/wiki) for additional and relevant information about the project.
37
+
Check out the [wiki](https://github.com/OAI/OpenAPI-Specification/wiki) for additional and relevant information about the project.
40
38
41
39
This includes:
42
40
- Static sample tutorial.
@@ -49,13 +47,13 @@ If you just want to see it work, check out the [pet store sample](http://petstor
49
47
50
48
## Tools and Libraries
51
49
52
-
Looking to see how you can create your own Swagger definition, present it or otherwise use it? Check out our [list of tools](http://swagger.io/open-source-integrations/) over at [http://swagger.io](http://swagger.io/open-source-integrations/).
50
+
Looking to see how you can create your own OpenAPI definition, present it or otherwise use it? Check out our [list of tools](http://swagger.io/open-source-integrations/) over at [http://swagger.io](http://swagger.io/open-source-integrations/).
53
51
54
52
(Yes, there used to be a really long list here, we just moved it to the main website)
55
53
56
54
## License
57
55
58
-
Copyright 2015 SmartBear Software
56
+
Copyright 2015 The Linux Foundation
59
57
60
58
Licensed under the Apache License, Version 2.0 (the "License");
61
59
you may not use this file except in compliance with the License.
@@ -66,4 +64,3 @@ distributed under the License is distributed on an "AS IS" BASIS,
66
64
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
67
65
See the License for the specific language governing permissions and
0 commit comments