|
Los tipos de archivo clásicos dejarán de estar disponibles a partir de enero de 2021. Puedes hacer una transición de tus archivos clásicos o descargar un PDF. Más información

Centro de soporte de Workiva

Comandos de solicitud HTTP

Comandos de solicitud HTTP

  • Última actualización

Una conexión de Solicitudes HTTP ejecuta estos comandos para realizar solicitudes comunes del Protocolo de Transferencia de Hipertexto (HTTP) a una URL determinada para conectar y automatizar soluciones compatibles a través de sus respectivos conectores.

Para ver cómo se estructura una Solicitud HTTP, consulta nuestra lista de ejemplos de Conectores HTTP .

Nota: Aunque está etiquetado como Solicitud HTTP, se admite HTTPS (HTTP seguro) (y es recomendable).

Requisitos

  • Aunque la conexión no tiene características específicas de OData, puedes añadir los componentes necesarios de la solicitud a través de los parámetros Encabezados o Cadena de consulta.
  • Para activar la autenticación mutua TLS (mTLS), proporcionar un par de claves pública/privada y, opcionalmente, un certificado CA. Para utilizar las claves pública y privada, súbelas como recursos del espacio de trabajo, y luego selecciónalas para los parámetros del comando Certificado y Clave privada del certificado, respectivamente.
  • El archivo que contiene la clave privada no debe estar cifrado. Cargar un archivo cifrado como clave privada dará lugar a un error.

Para habilitar estos comandos, primero un administrador informático crea un conector HTTP de Solicitudes.

Eliminar

Para eliminar un recurso, utiliza el comando Eliminar. Este comando realiza una solicitud HTTP DELETE, como http://postman-echo.com/delete.

Propiedades

Propiedad Detalle
Nombre de usuario Si se requiere autenticación básica, introduce el nombre de usuario.
Contraseña Si se requiere autenticación básica, introduce la contraseña.
certificado de entidad de certificación Introduce el certificado de la Autoridad de Certificación (CA) que se utilizará al hacer la solicitud (opcional).
Certificado Introduce el certificado a enviar con la solicitud (opcional). Si se proporciona, introduce también Clave privada del certificado.
Clave privada del certificado Introduce la clave privada para Certificado, si se ha proporcionado.
Mostrar respuesta Para mostrar el cuerpo de la respuesta de la API en el resultado, marca esta casilla.
URL Introduce la URL utilizada para la solicitud, como http://postman-echo.com/delete.
Tipo de contenido Establece el encabezado del tipo de contenido. Especifica el formato que se espera enviar al cuerpo de la solicitud.
Archivo del cuerpo. Introduce el archivo que contiene el objeto JSON o los parámetros de la solicitud para enviarlos en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Cuerpo del texto.
Cuerpo del texto Introduce el texto a enviar en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Archivo del cuerpo.
Encabezados Introduce los encabezados adicionales que quieras añadir a la solicitud.

Resultados

Resultado Tipo de resultado
Encabezados de respuesta JSON
Respuesta Archivo
Código de respuesta Entero

Códigos de salida

Código Tipo Detalle
0 Correcto Correcto
2 Error Error en la solicitud: sin código de respuesta 200
4 Error Certificado no encontrado
5 Error Encabezados de solicitud no válidos

Obtener

Para recuperar un recurso, utiliza un comando Get. Este comando realiza una solicitud HTTP GET, como https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Nota: Este comando incluye un espacio para introducir parámetros de consulta -- los parámetros no deben incluirse en la propia URL. Si se introducen parámetros tanto en la URL como en el campo "Cadena de consulta", se eliminarán de la URL.

Propiedades

Propiedad Detalle
Nombre de usuario Si se requiere autenticación básica, introduce el nombre de usuario.
Contraseña Si se requiere autenticación básica, introduce la contraseña.
certificado de entidad de certificación Introduce el certificado de CA que se utilizará al hacer la solicitud (opcional).
Certificado Introduce el certificado a enviar con la solicitud (opcional). Si se proporciona, introduce también Clave privada del certificado.
Clave privada del certificado Introduce la clave privada para Certificado, si se ha proporcionado.
Mostrar respuesta Para mostrar el cuerpo de la respuesta de la API en el resultado, marca esta casilla.
URL Introduce la URL utilizada para la solicitud, como https://postman-echo.com/get.
Cadena de consulta

Introduce la cadena de consulta que quieras añadir a la solicitud, como foo1=bar1&foo2=bar2.

Nota: La cadena de consulta debe estar codificada.
Encabezados Introduce los encabezados adicionales que quieras añadir a la solicitud.
Tipo de contenido Establece el tipo de contenido de la cabecera, como application/json. Especifica el formato que se espera enviar al cuerpo de la solicitud.
Esquema de resultado Para que los comandos posteriores de la cadena puedan acceder a las propiedades de salida de este comando, introduce una carga útil de muestra para cada salida JSON. 

Resultados

Resultado Tipo de resultado
Encabezados de respuesta JSON
Respuesta Archivo
Código de respuesta Entero

Códigos de salida

Código Tipo Detalle
0 Correcto Correcto
2 Error Error en la solicitud: sin código de respuesta 200
4 Error Certificado no encontrado
5 Error Encabezados de solicitud no válidos

Publicar

Para publicar un recurso, utiliza el comando Publicar. Este comando realiza una solicitud HTTP POST, como https://postman-echo.com/post.

Propiedades

Propiedad Detalle
Nombre de usuario Si se requiere autenticación básica, introduce el nombre de usuario.
Contraseña Si se requiere autenticación básica, introduce la contraseña.
certificado de entidad de certificación Introduce el certificado de CA que se utilizará al hacer la solicitud (opcional).
Certificado Introduce el certificado a enviar con la solicitud (opcional). Si se proporciona, introduce también Clave privada del certificado.
Clave privada del certificado Introduce la clave privada para Certificado, si se ha proporcionado.
Mostrar respuesta Para mostrar el cuerpo de la respuesta de la API en el resultado, marca esta casilla.
URL Introduce la URL utilizada para la solicitud, como https://postman-echo.com/post.
Tipo de contenido

Establece el encabezado del tipo de contenido. Especifica el formato que se espera enviar al cuerpo de la solicitud.

Nota: Para datos de varias partes, añade Valores del formulario en su lugar para generar el cuerpo.
Archivo del cuerpo. Introduce el archivo que contiene el objeto JSON o los parámetros de la solicitud para enviarlos en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Cuerpo del texto.
Cuerpo del texto

Introduce el texto a enviar en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Archivo del cuerpo.
Sugerencia: Si hay parámetros de selección múltiple, usa el siguiente patrón:

{ "queryId": "YOUR_QUERY_ID", "parameters": { "yourParamName": ["value1", "value2"] } }
Encabezados Introduce los encabezados adicionales que quieras añadir a la solicitud.
Valores del Formulario Para generar el cuerpo de los datos de varias partes, agrega los valores del formulario a incluir en la solicitud, e introduce el nombre y el valor de cada uno. Si añades valores de formulario, deja en blanco Tipo de contenido.
Esquema de resultado Para que los comandos posteriores de la cadena puedan acceder a las propiedades de salida de este comando, introduce una carga útil de muestra para cada salida JSON. 

Resultados

Resultado Tipo de resultado
Encabezados de respuesta JSON
Respuesta Archivo
Código de respuesta Entero

Códigos de salida

Código Tipo Detalle
0 Correcto Correcto
2 Error Error en la solicitud: sin código de respuesta 200
4 Error Certificado no encontrado
5 Error Encabezados de solicitud no válidos

Pon

Para cambiar o actualizar un recurso, utiliza un comando Poner. Este comando realiza una solicitud HTTP PUT, como https://postman-echo.com/put.

Propiedades

Propiedad Detalle
Nombre de usuario Si se requiere autenticación básica, introduce el nombre de usuario.
Contraseña Si se requiere autenticación básica, introduce la contraseña.
certificado de entidad de certificación Introduce el certificado de CA que se utilizará al hacer la solicitud (opcional).
Certificado Introduce el certificado a enviar con la solicitud (opcional). Si se proporciona, introduce también Clave privada del certificado.
Clave privada del certificado Introduce la clave privada para Certificado, si se ha proporcionado.
Mostrar respuesta Para mostrar el cuerpo de la respuesta de la API en el resultado, marca esta casilla.
URL Introduce la URL utilizada para la solicitud.
Tipo de contenido

Establece el encabezado del tipo de contenido. Especifica el formato que se espera enviar al cuerpo de la solicitud.

Nota: Para datos de varias partes, añade Valores del formulario en su lugar para generar el cuerpo.
Archivo del cuerpo. Introduce el archivo que contiene el objeto JSON o los parámetros de la solicitud para enviarlos en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Cuerpo del texto.
Cuerpo del texto Introduce el texto a enviar en el cuerpo de la solicitud. Si lo incluyes, deja en blanco Archivo del cuerpo.
Encabezados Introduce los encabezados adicionales que quieras añadir a la solicitud.
Valores del Formulario Para generar el cuerpo de los datos de varias partes, agrega los valores del formulario a incluir en la solicitud, e introduce el nombre y el valor de cada uno. Si añades valores de formulario, deja en blanco Tipo de contenido.
Esquema de resultado Para que los comandos posteriores de la cadena puedan acceder a las propiedades de salida de este comando, introduce una carga útil de muestra para cada salida JSON.

Resultados

Resultado Tipo de resultado
Encabezados de respuesta JSON
Respuesta Archivo
Código de respuesta Entero

Códigos de salida

Código Tipo Detalle
0 Correcto Correcto
2 Error Error en la solicitud: sin código de respuesta 200
4 Error Certificado no encontrado
5 Error Encabezados de solicitud no válidos
Una conexión de Solicitudes HTTP ejecuta estos comandos para realizar solicitudes comunes del Protocolo de Transferen...