Métodos de petición HTTP

Consulta cualquier método de petición HTTP registrado: qué hace, qué especificación lo define y si es seguro e idempotente. La tabla cubre los nueve métodos principales y las extensiones WebDAV, DeltaV y CalDAV.

Se ejecuta localmente en tu navegador
MétodoDefinido enSeguro / idempotentePropósito
Métodos principales
GETRFC 9110 §9.3.1sí / síObtiene una representación del recurso de destino.
HEADRFC 9110 §9.3.2sí / síObtiene solo las cabeceras de la respuesta, sin el cuerpo.
POSTRFC 9110 §9.3.3no / noEnvía datos al recurso de destino para que los procese; a menudo crea un recurso o inicia una acción.
PUTRFC 9110 §9.3.4no / síCrea el recurso de destino o lo reemplaza por el contenido de la petición.
DELETERFC 9110 §9.3.5no / síElimina el recurso de destino.
CONNECTRFC 9110 §9.3.6no / noAbre un túnel hacia la autoridad de destino, normalmente a través de un proxy.
OPTIONSRFC 9110 §9.3.7sí / síPregunta qué métodos y opciones admite el recurso de destino.
TRACERFC 9110 §9.3.8sí / síPide al servidor que devuelva la petición recibida para diagnosticarla.
PATCHRFC 5789 §2no / noAplica al recurso de destino los cambios descritos en el contenido de la petición.
Extensiones WebDAV
PROPFINDRFC 4918 §9.1sí / síLee las propiedades de un recurso; la cabecera Depth elige la profundidad del árbol.
PROPPATCHRFC 4918 §9.2no / síDefine o elimina varias propiedades de un recurso en una sola petición.
MKCOLRFC 4918 §9.3no / síCrea una colección, el recurso de WebDAV similar a una carpeta.
COPYRFC 4918 §9.8no / síCopia un recurso al URI indicado en la cabecera Destination.
MOVERFC 4918 §9.9no / síMueve un recurso al URI indicado en la cabecera Destination.
LOCKRFC 4918 §9.10no / noBloquea un recurso en modo escritura y devuelve un testigo de bloqueo.
UNLOCKRFC 4918 §9.11no / síLibera un bloqueo con el testigo de la cabecera Lock-Token.
ACLRFC 3744 §8.1no / síLee o cambia la lista de control de acceso de un recurso.
SEARCHRFC 5323 §2sí / síEjecuta una consulta DASL sobre una colección y devuelve los recursos que coinciden.
MKCALENDARRFC 4791 §5.3.1no / síCrea una colección de calendario con sus propiedades.
BINDRFC 5842 §4no / síAñade un recurso existente a una colección como nueva vinculación.
UNBINDRFC 5842 §5no / síElimina una vinculación de una colección.
REBINDRFC 5842 §6no / síMueve una vinculación de una colección a otra.
ORDERPATCHRFC 3648 §7no / síCambia la posición de los miembros de una colección ordenada.
MKREDIRECTREFRFC 4437 §6no / síCrea un recurso de referencia de redirección que apunta a otro URI.
UPDATEREDIRECTREFRFC 4437 §7no / síCambia el URI de destino de un recurso de referencia de redirección.
Extensiones de versiones (DeltaV)
VERSION-CONTROLRFC 3253 §3.5no / síPone un recurso bajo control de versiones.
REPORTRFC 3253 §3.6sí / síPide un informe de versiones, de propiedades o DAV sobre un recurso.
CHECKOUTRFC 3253 §8.8no / síHace escribible un recurso versionado o crea un recurso de trabajo.
CHECKINRFC 3253 §9.4no / síGuarda los cambios como una versión nueva y devuelve el recurso a solo lectura.
UNCHECKOUTRFC 3253 §4.5no / síCancela el checkout y descarta los cambios no confirmados.
MKWORKSPACERFC 3253 §6.3no / síCrea un espacio de trabajo para el trabajo versionado.
UPDATERFC 3253 §7.1no / síAplica los cambios de una versión a otro recurso.
LABELRFC 3253 §8.2no / síAñade o elimina una etiqueta en las versiones.
MERGERFC 3253 §11.2no / síFusiona las diferencias entre dos historiales de versiones.
BASELINE-CONTROLRFC 3253 §12.6no / síConvierte una colección en una colección controlada por líneas base.
MKACTIVITYRFC 3253 §13.5no / síCrea una actividad que agrupa cambios de varios recursos.
Otros métodos registrados
QUERYRFC 10008 §2sí / síEnvía una consulta segura e idempotente con los parámetros en el contenido.
PRIRFC 9113 §3.4sí / síSolo se envía en el preámbulo de conexión HTTP/2, antes de cualquier trama.
Eliminados de HTTP
LINKRFC 2068 §19.6.1.2no / síDefinido en la RFC 2068 para crear enlaces entre recursos; las revisiones posteriores de HTTP lo eliminaron.
UNLINKRFC 2068 §19.6.1.3no / síDefinido en la RFC 2068 para eliminar enlaces entre recursos; las revisiones posteriores de HTTP lo eliminaron.

Cómo leer esta referencia de métodos

Esta página recoge todos los métodos del registro de métodos HTTP de la IANA, el registro que mantiene la IETF. Cada fila indica el nombre del método, la especificación que lo define, si es seguro e idempotente y una línea sobre lo que hace.

Las filas vienen con la página: nada se genera en tiempo de ejecución, no hay que introducir datos y no se envía ninguna petición mientras lees. El buscador solo filtra la tabla en tu navegador.

  1. Filtra la tabla escribiendo parte del nombre de un método, un número de RFC o una palabra de la descripción en el buscador; el contador muestra cuántas entradas siguen visibles.
  2. Consulta la columna Definido en para llegar a la especificación. El signo de sección señala el apartado que define el método, por ejemplo RFC 9110 §9.3.1 para GET.
  3. Mira Seguro / idempotente antes de repetir una petición: un método seguro está definido como de solo lectura y uno idempotente puede enviarse de nuevo con el mismo efecto.
  4. Usa Copiar fila si necesitas la línea completa, o selecciona una celda. La tabla es una referencia: nada se convierte, se guarda ni se sube.

Qué significan las columnas y el registro

Seguro e idempotente

Un método es seguro cuando la especificación lo define como de solo lectura: GET, HEAD, OPTIONS, TRACE, PROPFIND, REPORT, SEARCH, QUERY y PRI están marcados como seguros en el registro. Seguro describe la intención, no los efectos que el servidor decida añadir: una petición GET puede registrarse, contarse o facturarse.

Un método es idempotente cuando repetir la misma petición tiene el mismo efecto que enviarla una vez. PUT, DELETE y casi todos los métodos WebDAV y DeltaV son idempotentes; POST, PATCH, CONNECT y LOCK no lo son, así que un cliente o un proxy no deben repetirlos automáticamente tras un tiempo de espera.

El registro manda

La IANA actualiza el registro cuando se publican métodos nuevos, y esta tabla lo sigue: el nombre, las marcas de seguro e idempotente y la primera especificación de la lista. Cuando el registro añade más especificaciones —MKCOL se amplía en la RFC 5689, PROPFIND y REPORT en la RFC 8144— se muestra la RFC que define el método.

Existen métodos fuera del registro. UPnP SSDP envía M-SEARCH por UDP, la RFC 2774 define métodos de extensión con prefijo M- como M-GET, y muchas API inventan sus propios verbos; un servidor que no reconoce un método responde 405 Method Not Allowed y un proxy puede rechazarlo directamente.

Métodos retirados y específicos de protocolo

LINK y UNLINK vienen de la RFC 2068, la primera especificación de HTTP/1.1, y se retiraron después: el registro todavía los lista con su referencia de borrador, pero ninguna especificación actual de HTTP los usa.

PRI se envía una vez por conexión, en el preámbulo de HTTP/2, antes de cualquier trama; el registro también incluye la forma de asterisco, que se usa como OPTIONS * para dirigirse al servidor entero y no a un recurso. Es fácil confundirlos al leer un registro de peticiones.

Herramientas recientes: