1- # openapi: "3.0.0"
2- # info:
3- # version: 1.0.0
4- # title: Swagger Petstore
5- # paths:
6- # /pets:
7- # get:
8- # responses:
9- # 206: # Noncompliant {{OAR031: Responses must have one or more examples defined}}
10- # description: Pet list
11- # content:
12- # application/json:
13- # schema:
14- # $ref: '#/components/schemas/pets'
15- # default:
16- # $ref: "#/components/responses/server_error_response"
17- # /pets/{id}:
18- # parameters:
19- # - in: query # Noncompliant {{OAR031: Parameters must have one or more examples defined}}
20- # name: $start
21- # schema:
22- # type: integer
23- # get:
24- # parameters:
25- # - $ref: "#/components/parameters/id"
26- # responses:
27- # 200: # Noncompliant {{OAR031: Responses must have one or more examples defined}}
28- # description: One pet
29- # content:
30- # application/json:
31- # schema:
32- # $ref: "#/components/schemas/pet"
33- # default:
34- # $ref: "#/components/responses/server_error_response"
35-
36- # components:
37- # parameters:
38- # id:
39- # in: path # Noncompliant {{OAR031: Parameters must have one or more examples defined}}
40- # name: id
41- # schema:
42- # type: integer
43- # format: int64
44- # maxLength: 22
45- # description: Identificador del tipo de centro a obtener, actualizar o eliminar.
46- # required: true
47- # schemas:
48- # pet:
49- # type: object
50- # properties:
51- # name: # Noncompliant {{OAR031: Properties must have an example defined}}
52- # type: string
53- # type: # Noncompliant {{OAR031: Properties must have an example defined}}
54- # type: string
55- # pets:
56- # type: object
57- # properties:
58- # size: # Noncompliant {{OAR031: Properties must have an example defined}}
59- # type: integer
60- # pets: # Noncompliant {{OAR031: Properties must have an example defined}}
61- # type: array
62- # items:
63- # $ref: '#/components/schemas/pet'
64- # responses:
65- # server_error_response: # Noncompliant {{OAR031: Responses must have one or more examples defined}}
66- # description: Default error response
67- # content:
68- # application/json:
69- # schema:
70- # type: object
71- # properties:
72- # error: # Noncompliant {{OAR031: Properties must have an example defined}}
73- # type: string
74-
751openapi : " 3.0.0"
762info :
77- title : API de Migraciones
783 version : 1.0.0
79-
4+ title : Swagger Petstore
805paths :
81- /migraciones :
6+ /pets :
7+ get :
8+ responses :
9+ 206 : # Noncompliant {{OAR031: Responses must have one or more examples defined}}
10+ description : Pet list
11+ content :
12+ application/json :
13+ schema :
14+ $ref : ' #/components/schemas/pets'
15+ default :
16+ $ref : " #/components/responses/server_error_response"
17+ /pets/{id} :
18+ parameters :
19+ - in : query # Noncompliant {{OAR031: Parameters must have one or more examples defined}}
20+ name : $start
21+ schema :
22+ type : integer
8223 get :
83- summary : Obtiene la lista de migraciones
84- description : Endpoint que devuelve la lista de migraciones existentes.
24+ parameters :
25+ - $ref : " #/components/parameters/id "
8526 responses :
86- 200 :
87- $ref : ' #/components/responses/migracion_get_response'
27+ 200 : # Noncompliant {{OAR031: Responses must have one or more examples defined}}
28+ description : One pet
29+ content :
30+ application/json :
31+ schema :
32+ $ref : " #/components/schemas/pet"
8833 default :
89- $ref : ' #/components/responses/server_error_response'
34+ $ref : " #/components/responses/server_error_response"
9035
9136components :
92- schemas :
37+ parameters :
9338 id :
94- type : string
95- example : " abc123"
96-
97- standard_response_with_metadata :
39+ in : path # Noncompliant {{OAR031: Parameters must have one or more examples defined}}
40+ name : id
41+ schema :
42+ type : integer
43+ format : int64
44+ maxLength : 22
45+ description : Identificador del tipo de centro a obtener, actualizar o eliminar.
46+ required : true
47+ schemas :
48+ pet :
9849 type : object
9950 properties :
100- metadata :
101- type : object
102- properties :
103- total :
104- type : integer
105- example : 1
106- page :
107- type : integer
108- example : 1
109- limit :
110- type : integer
111- example : 10
112- migracion_get_response :
51+ name : # Noncompliant {{OAR031: Properties must have an example defined}}
52+ type : string
53+ type : # Noncompliant {{OAR031: Properties must have an example defined}}
54+ type : string
55+ pets :
11356 type : object
11457 properties :
115- metadata :
116- type : object
117- properties :
118- total :
119- type : integer
120- example : 1
121- page :
122- type : integer
123- example : 1
124- limit :
125- type : integer
126- example : 10
127-
128-
129- examples :
130- migracion_get_response :
131- summary : Ejemplo de respuesta exitosa
132- value :
133- metadata :
134- total : 1
135- page : 1
136- limit : 10
137- data :
138- migraciones :
139- - id : " migracion-001"
140- nombre : " Migración inicial"
141- estado : " completada"
142-
58+ size : # Noncompliant {{OAR031: Properties must have an example defined}}
59+ type : integer
60+ pets :
61+ type : array
62+ items :
63+ $ref : ' #/components/schemas/pet'
14364 responses :
14465 server_error_response : # Noncompliant {{OAR031: Responses must have one or more examples defined}}
145- description : Respuesta de error genérica del servidor
66+ description : Default error response
14667 content :
14768 application/json :
14869 schema :
14970 type : object
15071 properties :
151- error :
152- type : string
153- example : " Error interno del servidor"
154- migracion_get_response :
155- description : Datos de la consulta migración obtenidos exitosamente.
156- content :
157- application/json :
158- schema :
159- allOf :
160- - $ref : ' #/components/schemas/standard_response_with_metadata'
161- properties :
162- data :
163- type : object
164- properties :
165- migraciones :
166- type : array
167- items :
168- $ref : ' #/components/schemas/migracion_get_response'
169- example : ['an example']
170- examples :
171- Ejemplo 1 :
172- $ref : ' #/components/examples/migracion_get_response'
72+ error : # Noncompliant {{OAR031: Properties must have an example defined}}
73+ type : string
0 commit comments