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
Copy file name to clipboardExpand all lines: docs/es/docs/advanced/additional-responses.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ Si estás comenzando con **FastAPI**, puede que no lo necesites.
8
8
9
9
///
10
10
11
-
Puedes declarar responses adicionales, con códigos de estado adicionales,tipos de medios, descripciones, etc.
11
+
Puedes declarar responses adicionales, con códigos de estado adicionales,media types, descripciones, etc.
12
12
13
13
Esos responses adicionales se incluirán en el esquema de OpenAPI, por lo que también aparecerán en la documentación de la API.
14
14
@@ -43,7 +43,7 @@ La clave `model` no es parte de OpenAPI.
43
43
El lugar correcto es:
44
44
45
45
* En la clave`content`, que tiene como valor otro objeto JSON (`dict`) que contiene:
46
-
* Una clave con eltipo de medio, por ejemplo,`application/json`, que contiene como valor otro objeto JSON, que contiene:
46
+
* Una clave con elmedia type, por ejemplo,`application/json`, que contiene como valor otro objeto JSON, que contiene:
47
47
* Una clave`schema`, que tiene como valor el JSON Schema del modelo, aquí es el lugar correcto.
48
48
***FastAPI** agrega una referencia aquí a los JSON Schemas globales en otro lugar de tu OpenAPI en lugar de incluirlo directamente. De este modo, otras aplicaciones y clientes pueden usar esos JSON Schemas directamente, proporcionar mejores herramientas de generación de código, etc.
49
49
@@ -169,11 +169,11 @@ Los esquemas se referencian a otro lugar dentro del esquema de OpenAPI:
169
169
}
170
170
```
171
171
172
-
##Tipos de medios adicionales para el response principal
172
+
##Media types adicionales para el response principal
173
173
174
-
Puedes usar este mismo parámetro`responses` para agregar diferentestipos de medios para el mismo response principal.
174
+
Puedes usar este mismo parámetro`responses` para agregar diferentesmedia type para el mismo response principal.
175
175
176
-
Por ejemplo, puedes agregar untipo de medioadicional de`image/png`, declarando que tu*path operation* puede devolver un objeto JSON (contipo de medio`application/json`) o una imagen PNG:
176
+
Por ejemplo, puedes agregar unmedia typeadicional de`image/png`, declarando que tu*path operation* puede devolver un objeto JSON (conmedia type`application/json`) o una imagen PNG:
@@ -185,9 +185,9 @@ Nota que debes devolver la imagen usando un `FileResponse` directamente.
185
185
186
186
/// info | Información
187
187
188
-
A menos que especifiques untipo de mediodiferente explícitamente en tu parámetro`responses`, FastAPI asumirá que el response tiene el mismotipo de medio que la clase de response principal (por defecto`application/json`).
188
+
A menos que especifiques unmedia typediferente explícitamente en tu parámetro`responses`, FastAPI asumirá que el response tiene el mismomedia type que la clase de response principal (por defecto`application/json`).
189
189
190
-
Pero si has especificado una clase de response personalizada con`None` como sutipo de medio, FastAPI usará`application/json` para cualquier response adicional que tenga un modelo asociado.
190
+
Pero si has especificado una clase de response personalizada con`None` como sumedia type, FastAPI usará`application/json` para cualquier response adicional que tenga un modelo asociado.
191
191
192
192
///
193
193
@@ -244,4 +244,4 @@ Por ejemplo:
244
244
Para ver exactamente qué puedes incluir en los responses, puedes revisar estas secciones en la especificación OpenAPI:
245
245
246
246
* <ahref="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#responses-object"class="external-link"target="_blank">Objeto de Responses de OpenAPI</a>, incluye el`Response Object`.
247
-
* <ahref="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#response-object"class="external-link"target="_blank">Objeto de Response de OpenAPI</a>, puedes incluir cualquier cosa de esto directamente en cada response dentro de tu parámetro`responses`. Incluyendo`description`,`headers`,`content` (dentro de este es que declaras diferentestipos de medios y JSON Schemas), y`links`.
247
+
* <ahref="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#response-object"class="external-link"target="_blank">Objeto de Response de OpenAPI</a>, puedes incluir cualquier cosa de esto directamente en cada response dentro de tu parámetro`responses`. Incluyendo`description`,`headers`,`content` (dentro de este es que declaras diferentesmedia types y JSON Schemas), y`links`.