📝 Add Spanish translation for HTTP QUERY method section
- Translate experimental HTTP QUERY method documentation
- Add warning about non-standard HTTP method
- Include code example and limitations section
- Add tip about preferring POST for interoperability
Brings Spanish docs up to date with English version in docs/en/docs/how-to/custom-request-and-route.md
@ -107,3 +107,41 @@ También puedes establecer el parámetro `route_class` de un `APIRouter`:
En este ejemplo, las *path operations* bajo el `router` usarán la clase personalizada `TimedRoute`, y tendrán un header `X-Response-Time` extra en el response con el tiempo que tomó generar el response:
Esta es una funcionalidad experimental para el método HTTP QUERY no estándar. Úsalo con precaución.
///
FastAPI y `APIRouter` exponen un decorador `.query()` para el método HTTP QUERY experimental, tal como se define en el <ahref="https://www.ietf.org/archive/id/draft-ietf-httpbis-safe-method-w-body-02.html"class="external-link"target="_blank">borrador del IETF para "método seguro con cuerpo"</a>.
El método QUERY funciona en tiempo de ejecución y puede usarse como cualquier otro decorador de método HTTP:
* **No se muestra en la documentación interactiva**: El método QUERY no aparecerá en el esquema OpenAPI ni en la documentación interactiva (Swagger UI, ReDoc) porque la especificación OpenAPI no define operaciones "query".
* **Soporte limitado de clientes**: No todos los clientes HTTP y proxies soportan el método QUERY.
/// tip | Consejo
Para máxima interoperabilidad, prefiere usar **POST** para operaciones que requieren un cuerpo de request. El método QUERY solo es útil en escenarios especializados donde necesitas seguir la especificación del borrador del IETF.