Referencia de métodos HTTP

• Búsqueda instantánea en todos los métodos HTTP: nuestra referencia te permite buscar por nombre de método, descripción o caso de uso en tiempo real. Encuentra exactamente lo que necesitas, ya busques reglas de idempotencia, códigos de estado o requisitos del cuerpo de la petición.
• Tarjetas desplegables con semántica completa: cada tarjeta de método HTTP se despliega para mostrar la semántica completa: propiedades de seguro/idempotente/cacheable, casos de uso comunes, requisitos de cuerpo, códigos de estado de éxito y error, y ejemplos de peticiones listos para copiar.
• Referencia de métodos HTTP online y segura: se ejecuta íntegramente en tu navegador: no se envía ningún dato a ningún servidor. Todos los datos de referencia se cargan localmente, por lo que la herramienta funciona totalmente sin conexión una vez cargada la página.
• Referencia de métodos HTTP sin instalación y 100 % gratis: úsala directamente en cualquier navegador, sin descargas, cuenta ni anuncios. Filtra por método, despliega todas las tarjetas a la vez y copia ejemplos de peticiones, totalmente gratis para siempre.

• Diseño de API REST: usa nuestra referencia de métodos HTTP para elegir el método correcto al diseñar API REST. Entiende cuándo usar PUT frente a PATCH, o POST frente a PUT, para construir endpoints semánticamente correctos y predecibles.
• Integración y depuración de API: los desarrolladores que integran API de terceros usan nuestra referencia para entender qué hace cada método y qué códigos de estado esperar. Consulta rápidamente si un método es idempotente antes de reintentar peticiones fallidas.
• Desarrollo backend: los ingenieros de backend usan nuestra referencia para implementar manejadores de rutas correctos. Entiende qué métodos requieren cuerpo de petición, cuáles deben devolver 201 frente a 200 y cuáles se pueden cachear.
• Desarrollo frontend y de cliente: los desarrolladores frontend usan nuestra referencia para escribir llamadas correctas con fetch y Axios. Saben cuándo usar POST para enviar formularios, GET para obtener datos y DELETE para eliminar recursos.
• Redacción de documentación de API: los redactores técnicos usan nuestra referencia para documentar API con precisión. Consulta la semántica, las reglas de idempotencia y los códigos de estado correctos de cada método en tu documentación OpenAPI o Swagger.
• Aprendizaje y preparación de entrevistas: los desarrolladores que aprenden REST o preparan entrevistas técnicas usan nuestra referencia para dominar la semántica HTTP. Entienden métodos seguros frente a idempotentes, el preflight CORS y la diferencia entre PUT y PATCH.

Los métodos HTTP (también llamados verbos HTTP) definen la acción a realizar sobre un recurso identificado por una URL. Son una parte central del protocolo HTTP y la base del diseño de API RESTful. Los métodos más usados son GET (obtener), POST (crear), PUT (reemplazar), PATCH (actualización parcial) y DELETE (eliminar). Otros métodos como HEAD , OPTIONS , CONNECT y TRACE cumplen propósitos especializados. Nuestra referencia de métodos HTTP cubre todos los métodos estándar con su semántica, casos de uso y detalles de petición y respuesta.

1. Explora o busca: usa la barra de búsqueda para encontrar cualquier método HTTP por nombre, descripción o caso de uso. O pulsa una píldora de filtro (GET, POST, PUT, etc.) para ir directamente a ese método. Todo el filtrado se ejecuta al instante en tu navegador.
2. Despliega para ver todos los detalles: haz clic en cualquier tarjeta de método para expandirla y ver la referencia completa: propiedades de seguro/idempotente/cacheable, casos de uso, requisitos de cuerpo, códigos de estado de éxito y error, y ejemplos de peticiones HTTP. Usa «Expandir todo» para abrir todos los métodos a la vez.
3. Copia ejemplos de peticiones: cada método incluye ejemplos de peticiones HTTP listos para copiar. Haz clic en el botón Copiar de cualquier ejemplo para copiarlo al portapapeles y usarlo en tu cliente de API, tu documentación o tu código.

• Seguro: un método es seguro si no modifica el estado del servidor. GET, HEAD y OPTIONS son seguros: solo recuperan información. POST, PUT, PATCH y DELETE no son seguros porque cambian datos en el servidor.
• Idempotente: un método es idempotente si repetir la misma petición varias veces produce el mismo resultado que hacerla una vez. GET, HEAD, OPTIONS, PUT y DELETE son idempotentes. POST no lo es: enviar el mismo POST dos veces suele crear dos recursos.
• Cacheable: un método es cacheable si sus respuestas se pueden almacenar y reutilizar. Las respuestas de GET y HEAD son cacheables por defecto. Las de POST solo son cacheables con cabeceras Cache-Control explícitas. Las de PUT, PATCH y DELETE no son cacheables.
• Cuerpo de la petición: algunos métodos llevan cuerpo de petición (POST, PUT, PATCH) y otros no (GET, HEAD, DELETE, OPTIONS). Enviar cuerpo con GET está técnicamente permitido pero se desaconseja y a menudo los servidores lo ignoran.

PUT reemplaza el recurso completo: debes enviar todos los campos, y cualquier campo no incluido se pondrá a null o a su valor por defecto. Usa PUT cuando quieras reemplazar por completo un recurso. PATCH aplica una actualización parcial: solo cambian los campos que envías y el resto se mantiene igual. Usa PATCH cuando solo necesites actualizar uno o unos pocos campos. En la práctica, la mayoría de las API REST modernas prefieren PATCH para actualizar porque es más eficiente y menos propenso a errores que enviar el recurso completo en cada actualización.