Typically, when you want to read data you use `GET`. If you need to send complex data (like a large JSON object) to filter that data, you traditionally had to use `POST` because `GET` requests does not support request bodies.
@ -6,7 +6,7 @@ However, using `POST` for read-only operations isn't semantically correct, as `P
There is a newer HTTP method called **QUERY**. It is designed exactly for this: performing safe, idempotent read operations that require a request body.
## Using `QUERY`
## Using `QUERY` { #using-query }
In **FastAPI**, you can use the `QUERY` method using the `@app.query()` decorator.
@ -15,16 +15,15 @@ It works similarly to `@app.post()`, allowing you to receive Pydantic models in
You can test it using an HTTP client that supports the `QUERY` method.
Because it allows a body, you can send complex filters without hitting URL length limits common with `GET` query parameters.
### Technical Details
### Technical Details { #technical-details }
The `QUERY` method is defined in the [IETF HTTP QUERY Method Draft](https://www.ietf.org/archive/id/draft-ietf-httpbis-safe-method-w-body-02.html). It is considered:
* **Safe**: It does not alter the state of the server (read-only).
* **Idempotent**: Making the same request multiple times yields the same result.