/
524.txt
62 lines (44 loc) · 2.98 KB
/
524.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
[FIG(quote)[
[FIGCAPTION[
[1] [CITE@en[Home | Open API Initiative]]
([TIME[2015-11-06 07:11:54 +09:00]] 版)
<https://openapis.org/>
]FIGCAPTION]
> The Open API Initiative (OAI) was created by a consortium of forward-looking industry experts who recognize the immense value of standardizing on how REST APIs are described. As an open governance structure under the Linux Foundation, the OAI is focused on creating, evolving and promoting a vendor neutral description format. SmartBear Software is donating the Swagger Specification directly to the OAI as the basis of this Open Specification.
]FIG]
[FIG(quote)[
[FIGCAPTION[
[2] [CITE@en[Specification | Open API Initiative]]
([TIME[2015-11-06 07:09:52 +09:00]] 版)
<https://openapis.org/specification>
]FIGCAPTION]
> Starting with version 2.0 of the Swagger Specification, the OAI will be involving API consumers, developers, providers, and vendors alike to build the most useful, comprehensive specification possible.
> The goal of the OAI 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, 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.
]FIG]
[FIG(quote)[
[FIGCAPTION[
[3] [CITE@en-US[Swagger – The World's Most Popular Framework for APIs.]]
( ([TIME[2017-03-21 16:25:34 +09:00]]))
<http://swagger.io/>
]FIGCAPTION]
> THE SWAGGER SPECIFICATION
> At the heart of the above tools is the Swagger Specification. The specification creates the RESTful contract for your API, detailing all of its resources and operations in a human and machine readable format for easy development, discovery, and integration.
> The specification is the basis of the OpenAPI Specification (OAS) and is developed in an open, transparent, and collaborative community to standardize the way RESTful interfaces are defined.
]FIG]
[4] [CITE@en-US[Repo | Open API Initiative]]
( ([TIME[2017-03-21 16:26:48 +09:00]]))
<https://www.openapis.org/specification/repo>
[5] [CITE@en[OAI/OpenAPI-Specification: The OpenAPI Specification Repository]]
( ([TIME[2017-03-21 16:27:01 +09:00]]))
<https://github.com/OAI/OpenAPI-Specification>
[FIG(quote)[
[FIGCAPTION[
[6] [CITE@en[OAI/OpenAPI-Specification: The OpenAPI Specification Repository]]
( ([TIME[2017-03-21 16:27:32 +09:00]]))
<https://github.com/OAI/OpenAPI-Specification#the-openapi-specification-fka-the-swagger-specification>
]FIGCAPTION]
> The OpenAPI Specification (fka The Swagger Specification)
]FIG]
[7] [CITE@en[OpenAPI-Specification/2.0.md at master · OAI/OpenAPI-Specification]]
( ([TIME[2017-03-21 16:27:48 +09:00]]))
<https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md>