🌐 Add Spanish translation for docs/tutorial/response-status-code.md#5466
🌐 Add Spanish translation for docs/tutorial/response-status-code.md#5466carlosm27 wants to merge 10 commits intofastapi:masterfrom
docs/tutorial/response-status-code.md#5466Conversation
carlosm27
changed the title
docs/tutorial/response-status-code.md
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## master #5466 +/- ##
=========================================
Coverage 100.00% 100.00%
=========================================
Files 540 540
Lines 13969 13946 -23
=========================================
- Hits 13969 13946 -23 ☔ View full report in Codecov by Sentry. |
|
📝 Docs preview for commit 7acfff1 at: https://633f092fb3ac08020cc9078d--fastapi.netlify.app |
|
I don't know why tests failed. I saw the test's details and they say the test fails in the file |
|
📝 Docs preview for commit 020a7c3 at: https://634430357c44910d6f811083--fastapi.netlify.app |
|
📝 Docs preview for commit 0c4cbed at: https://6357303925f221551d1eb4c7--fastapi.netlify.app |
tiangolo
changed the title
docs/tutorial/response-status-code.mddocs/tutorial/response-status-code.md
tiangolo
added
lang-all
|
📝 Docs preview for commit 15e2f6c at: https://639cc8727626050e7d0703ac--fastapi.netlify.app |
erudin
left a comment
erudin
left a comment
There was a problem hiding this comment.
Looks good! Thanks! Just a few small comments regarding missing accents and some rephrasing for clarity.
| @@ -0,0 +1,105 @@ | |||
| # Response Status Code | |||
|
|
|||
| De la misma manera que puedes especificar un modelo de respuesta, también puedes declarar codigos de estado HTTP | |||
There was a problem hiding this comment.
| De la misma manera que puedes especificar un modelo de respuesta, también puedes declarar codigos de estado HTTP | |
| De la misma manera que puedes especificar un modelo de respuesta, también puedes declarar códigos de estado HTTP |
| # Response Status Code | ||
|
|
||
| De la misma manera que puedes especificar un modelo de respuesta, también puedes declarar codigos de estado HTTP | ||
| usados para la respuesta con el parametro `status_code` en cualquiera de los *path operations*: |
There was a problem hiding this comment.
| usados para la respuesta con el parametro `status_code` en cualquiera de los *path operations*: | |
| usados para la respuesta con el parámetro `status_code` en cualquiera de los *path operations*: |
| ``` | ||
|
|
||
| !!! note | ||
| Toma en cuenta que `status_code` es un parámetro del método del "decorador" (`get`, `post`, etc)- |
There was a problem hiding this comment.
| Toma en cuenta que `status_code` es un parámetro del método del "decorador" (`get`, `post`, etc)- | |
| Ten en cuenta que `status_code` es un parámetro del método del "decorador" (`get`, `post`, etc)- |
| Será: | ||
|
|
||
| - Retorna ese código de estado en la respuesta. | ||
| - Documentado como en el OpenAPI "schema" (además, en la interfaz de usuario): |
There was a problem hiding this comment.
I'm trying to think in another way to say this part. Because it's a bit confusing, and the meaning is a bit lost.
What do you think about something like this?:
Esto:
- Devolverá ese código de estado en la respuesta.
- Lo documentará como tal en el esquema OpenAPI (y por lo tanto, en las interfaces de usuario):
|
|
||
|
|
||
| !!! note | ||
| Algunos códigos de respuesta (ve la siguiente sección) indica que la respuesta no tiene body. |
There was a problem hiding this comment.
| Algunos códigos de respuesta (ve la siguiente sección) indica que la respuesta no tiene body. | |
| Algunos códigos de respuesta (ve la siguiente sección) indica que la respuesta no tiene cuerpo. |
| - `300` en adelante son para "Redirección". Respuestas con estos códigos de estado pueden o no tener body, excepto para `304`, "No Modificado", | ||
| el cual no debe tener body. | ||
|
|
||
| - `400` en adelante son para respuestas para `Error del Cliente`. Estos son el segundo tipo de codigós que más usarás. |
There was a problem hiding this comment.
| - `400` en adelante son para respuestas para `Error del Cliente`. Estos son el segundo tipo de codigós que más usarás. | |
| - `400` en adelante son para respuestas de `Error del Cliente`. Estos son el segundo tipo de codigós que probablemente más usarás. |
| - Un ejemplo es `404`, para respuesta de "No encontrado". | ||
| - Para errores genéricos desde el cliente, puedes usar `400`. | ||
|
|
||
| - `500` en adelante son para errores del servidor. Tú nunca los usas directamente. Cuando algo sale mal en alguna parte del código de tu aplicación, |
There was a problem hiding this comment.
| - `500` en adelante son para errores del servidor. Tú nunca los usas directamente. Cuando algo sale mal en alguna parte del código de tu aplicación, | |
| - `500` en adelante son para errores del servidor. Tú casi nunca los usas directamente. Cuando algo sale mal en alguna parte del código de tu aplicación, |
| {!../../../docs_src/response_status_code/tutorial002.py!} | ||
| ``` | ||
|
|
||
| Son tan convenientes, mantienen el mismo número, pero puedes usar el autocompletado del editor para encontrarlas: |
There was a problem hiding this comment.
| Son tan convenientes, mantienen el mismo número, pero puedes usar el autocompletado del editor para encontrarlas: | |
| Son solo una conveniencia, mantienen el mismo número, pero puedes usar el autocompletado del editor para encontrarlas: |
|
|
||
|
|
||
| ``` | ||
| **FastAPI** provee el mismo `starlette.status` como `fastapi.status` conveniente para tí, el desarrollador. Pero viene directamente de Starlette. |
There was a problem hiding this comment.
| **FastAPI** provee el mismo `starlette.status` como `fastapi.status` conveniente para tí, el desarrollador. Pero viene directamente de Starlette. | |
| **FastAPI** provee el mismo `starlette.status` como `fastapi.status` solo como una conveniencia para tí, el desarrollador. Pero viene directamente desde Starlette. |
|
|
||
| # Cambiando el por defecto | ||
|
|
||
| Después, en la [Guía Avanzada de Usuario](https://github.com/carlosm27/fastapi/blob/master/docs/en/docs/advanced/response-change-status-code.md), verás cómo retornar diferentes códigos de estado que los de por defecto declaras aquí. |
There was a problem hiding this comment.
| Después, en la [Guía Avanzada de Usuario](https://github.com/carlosm27/fastapi/blob/master/docs/en/docs/advanced/response-change-status-code.md), verás cómo retornar diferentes códigos de estado que los de por defecto declaras aquí. | |
| Después, en la [Guía Avanzada de Usuario](https://github.com/carlosm27/fastapi/blob/master/docs/en/docs/advanced/response-change-status-code.md), verás cómo retornar un código de estado diferente al predeterminado que declaras aquí. |
There was a problem hiding this comment.
Isn't there any problem with the link to the forked repo?
| Algunos códigos de respuesta (ve la siguiente sección) indica que la respuesta no tiene body. | ||
|
|
||
| ``` | ||
| FastAPI sabe esto, y producirá documentatión OpenAPI diciendo que no hay body en la respuesta. |
There was a problem hiding this comment.
| FastAPI sabe esto, y producirá documentatión OpenAPI diciendo que no hay body en la respuesta. | |
| FastAPI sabe esto, y producirá documentación OpenAPI diciendo que no hay cuerpo en la respuesta. |
| El parámetro `status_code` recibe un número con el código del estado HTTP. | ||
|
|
||
| !!! info | ||
| `status_code` puede alternamente recibir un `IntEnum`, como <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a> de Python. |
There was a problem hiding this comment.
| `status_code` puede alternamente recibir un `IntEnum`, como <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a> de Python. | |
| `status_code` puede alternativamente recibir un `IntEnum`, como <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a> de Python. |
| En resumen: | ||
|
|
||
| - `100` en adelante son para "Información". Rara vez los usas directamente. Las respuestas con estos códigos de estado no tienen body. | ||
| - `200` en adelante son para respuestas "Exitosas". Esta son las que se usan con mayor frecuencia. |
There was a problem hiding this comment.
Here we are talking about "códigos de estado":
| - `200` en adelante son para respuestas "Exitosas". Esta son las que se usan con mayor frecuencia. | |
| - `200` en adelante son para respuestas "Exitosas". Estos son las que se usan con mayor frecuencia. |
|
|
||
| !!! tip | ||
| Para saber más acerca de estos códigos de estado y cuál código se usa para cada caso, revisa la | ||
| <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network"> documentación acerca de los códigos de estados MDN</abbr> . |
There was a problem hiding this comment.
It says "códigos de estado" in the previous line:
| <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network"> documentación acerca de los códigos de estados MDN</abbr> . | |
| <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network"> documentación acerca de los códigos de estado MDN</abbr> . |
|
|
||
| # Cambiando el por defecto | ||
|
|
||
| Después, en la [Guía Avanzada de Usuario](https://github.com/carlosm27/fastapi/blob/master/docs/en/docs/advanced/response-change-status-code.md), verás cómo retornar diferentes códigos de estado que los de por defecto declaras aquí. |
There was a problem hiding this comment.
Isn't there any problem with the link to the forked repo?
chesstrian
left a comment
chesstrian
left a comment
There was a problem hiding this comment.
The entry for the new translated page is missing from docs/es/mkdocs.yml.
|
📝 Docs preview for commit 9e4e2e2 at: https://63fd69dc9c8fe5334fd88386--fastapi.netlify.app |
|
@carlosm27 is it intended not to make changes over |
|
Hey @chesstrian. Honestly, I don't know. I think we make changes when a topic is added. |
|
@carlosm27 I mean this: https://fastapi.tiangolo.com/contributing/#tips-and-guidelines This is an example: https://github.com/tiangolo/fastapi/pull/9214/files#diff-03213f8a7ff7438ed5bbe5e7cfd9b2b9d6b959535380af941b07565ec20ba90eR69 Basically any PR that translates a new page needs to update |
|
Hey @chesstrian Thank you for sharing this. I didn't know about updating that file. |
|
📝 Docs preview for commit b37bb84 at: https://640e610576710f62ad103237--fastapi.netlify.app |
|
This was covered in another PR, so I'll close this one now, thanks for the effort! 🍰 ☕ |
4 participants
Hi folks, I hope all of you are well.
According to the Spanish Translation feature: #1218
This pull request includes the Spanish translation for tutorial/response-status-code.md
Thanks!