Te presentamos HTTP QUERY
QUERY es un método seguro e idempotente que lleva cuerpo de petición: en esencia, un «GET con cuerpo». Permite que los criterios de consulta complejos vivan en el cuerpo en lugar de inflar la URL, sin forzar POST, cuya semántica no encaja con consultar.
Aprende, prueba y verifica HTTP — incluido el nuevo QUERY
QUERY /productsNEWAccept: application/jsonContent-Type: application/json { "category": "boots", "inStock": true}200 OKContent-Location: /products?…Cache-Control: max-age=60 { "results": 42, "cacheable": true}La misma búsqueda, cuatro formas
La misma búsqueda de productos de cuatro maneras:
Desliza horizontalmente para comparar todos los métodos. QUERY aparece primero.
| Capacidad | QUERY | GET · URL | GET · body | POST |
|---|---|---|---|---|
| Cuerpo de la petición | JSON | ninguno | indefinido · evitar | JSON |
| Seguro (sin efectos secundarios) | ✓ | ✓ | ✓ | ✗ |
| Idempotente | ✓ | ✓ | ✓ | ✗ |
| Respuesta cacheable | ✓vía Content-Location | ✓ | ~poco fiable · indefinido | ~no por defecto · requiere explícito |
| Los filtros no van en la URL | ✓ | ✗ | ✓ | ✓ |
| Inmune a los límites de URL | ✓ | ✗límite ~2KB | ✓ | ✓ |
| Estandarizado y soportado | ~RFC nuevo · adopción temprana | ✓ | ✓ | ✓ |
Sigue explorando
Métodos
Semántica, seguridad, idempotencia y cacheabilidad de GET / POST / PUT / PATCH / DELETE / HEAD / OPTIONS y del nuevo método QUERY.
Playground
Elige un método, añade un cuerpo y lanza una petición real a un endpoint echo del mismo origen para ver exactamente cómo se reciben métodos como QUERY.
Códigos de estado
Explora los códigos de estado habituales agrupados de 1xx a 5xx, cada uno con un mensaje HTTP real de ejemplo.
Cabeceras
Cabeceras de petición y respuesta agrupadas por función — autenticación, caché, negociación de contenido, CORS, seguridad — con sintaxis y ejemplos.