Comandos de solicitação HTTP

Uma conexão HTTP Requests executa esses comandos para realizar solicitações comuns de HyperText Transfer Protocol (HTTP) a um determinado URL para conectar e automatizar soluções compatíveis por meio de seus respectivos conectores.

Para ver como uma Solicitação HTTP é estruturada, consulte nossa lista de exemplos do Conector HTTP .

Nota: Embora esteja etiquetado como solicitação HTTP, o HTTPS (HTTP seguro) é suportado (e recomendado).

Requisitos

Embora a conexão não tenha recursos específicos do OData, você pode adicionar qualquer componente necessário da solicitação por meio dos parâmetros Headers ou Query string.
Para habilitar a autenticação TLS mútua (mTLS), forneça um par de chaves pública/privada e, opcionalmente, um certificado de CA. Para usar as chaves pública e privada, faça upload delas como recursos do espaço de trabalho e selecione-as para os parâmetros do comando Certificate e Certificate private key, respectivamente.
O arquivo que contém a chave privada não deve ser criptografado. Se você carregar um arquivo criptografado como chave privada, ocorrerá um erro.

Para habilitar esses comandos, um administrador de TI primeiro cria um conector de solicitação HTTP.

Excluir

Para remover um recurso, use o comando Delete. Esse comando faz uma solicitação HTTP DELETE, como http://postman-echo.com/delete.

Propriedades

Propriedade	Detalhes
Nome de usuário	Se a autenticação básica for necessária, digite o nome de usuário.
Senha	Se a autenticação básica for necessária, digite a senha.
Certificado CA	Digite o certificado da autoridade de certificação (CA) a ser usado ao fazer a solicitação (opcional).
Certificado	Digite o certificado a ser enviado com a solicitação (opcional). Se fornecido, insira também Chave privada do certificado.
Chave privada do certificado	Digite a chave privada para Certificado, se fornecido.
Mostrar resposta	Para mostrar o corpo da resposta da API na saída, marque essa caixa.
URL	Digite o URL usado para a solicitação, como, por exemplo, `http://postman-echo.com/delete`.
Tipo de conteúdo	Digite o cabeçalho do tipo de conteúdo a ser definido. Especifica o formato esperado a ser enviado para o corpo da solicitação.
Arquivo do corpo	Digite o arquivo que contém o objeto JSON ou os parâmetros da solicitação a serem enviados no corpo da solicitação. Se você incluir isso, deixe Body text em branco.
Texto do corpo	Digite o texto a ser enviado no corpo da solicitação. Se você incluir isso, deixe em branco Body file.
Headers	Digite os cabeçalhos adicionais que você deseja adicionar à solicitação.

Saídas

Saída	Tipo de saída
Cabeçalhos de resposta	JSON
Resposta	Arquivo
Código de resposta	Inteiro

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
2	Erro	Falha na solicitação; código de resposta não-200
4	Erro	O certificado não foi encontrado
5	Erro	Cabeçalhos de solicitação inválidos

Obtenha

Para recuperar um recurso, use o comando Get. Esse comando faz uma solicitação HTTP GET, como https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Observação: Esse comando inclui um espaço para você inserir os parâmetros de consulta, que não devem ser incluídos no próprio URL. Se os parâmetros forem inseridos no URL e no campo "Query string", eles serão removidos do URL.

Propriedades

Propriedade	Detalhes
Nome de usuário	Se a autenticação básica for necessária, digite o nome de usuário.
Senha	Se a autenticação básica for necessária, digite a senha.
Certificado CA	Digite o certificado de CA a ser usado ao fazer a solicitação (opcional).
Certificado	Digite o certificado a ser enviado com a solicitação (opcional). Se fornecido, insira também Chave privada do certificado.
Chave privada do certificado	Digite a chave privada para Certificado, se fornecido.
Mostrar resposta	Para mostrar o corpo da resposta da API na saída, marque essa caixa.
URL	Digite o URL usado para a solicitação, como `https://postman-echo.com/get`.
Cadeia de consulta	Digite a cadeia de caracteres de consulta a ser anexada à solicitação, como `foo1=bar1&foo2=bar2`. Observação: A string de consulta deve ser codificada.
Headers	Digite os cabeçalhos adicionais a serem adicionados à solicitação.
Tipo de conteúdo	Digite o cabeçalho do tipo de conteúdo a ser definido, como `application/json`. Isso especifica o formato esperado a ser enviado para o corpo da solicitação.
Esquema de saída	Para permitir que comandos posteriores na cadeia acessem as propriedades de saída desse comando, insira uma carga útil de amostra para cada saída JSON.

Saídas

Saída	Tipo de saída
Cabeçalhos de resposta	JSON
Resposta	Arquivo
Código de resposta	Inteiro

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
2	Erro	Falha na solicitação; código de resposta não-200
4	Erro	O certificado não foi encontrado
5	Erro	Cabeçalhos de solicitação inválidos

Postar

Para colocar um recurso, use o comando Post. Esse comando faz uma solicitação HTTP POST, como https://postman-echo.com/post.

Propriedades

Propriedade	Detalhes
Nome de usuário	Se a autenticação básica for necessária, digite o nome de usuário.
Senha	Se a autenticação básica for necessária, digite a senha.
Certificado CA	Digite o certificado de CA a ser usado ao fazer a solicitação (opcional).
Certificado	Digite o certificado a ser enviado com a solicitação (opcional). Se fornecido, insira também Chave privada do certificado.
Chave privada do certificado	Digite a chave privada para Certificado, se fornecido.
Mostrar resposta	Para mostrar o corpo da resposta da API na saída, marque essa caixa.
URL	Digite o URL usado para a solicitação, como, por exemplo, `https://postman-echo.com/post`.
Tipo de conteúdo	Digite o cabeçalho do tipo de conteúdo a ser definido. Isso especifica o formato esperado a ser enviado para o corpo da solicitação. Observação: Para dados com várias partes, adicione Valores de formulário para gerar o corpo.
Arquivo de corpo	Digite o arquivo que contém o objeto JSON ou os parâmetros da solicitação a serem enviados no corpo da solicitação. Se você incluir isso, deixe Body text em branco.
Texto do corpo	Digite o texto a ser enviado no corpo da solicitação. Se você incluir isso, deixe em branco Body file.
Headers	Digite os cabeçalhos adicionais a serem adicionados à solicitação.
Valores do formulário	Para gerar o corpo para dados de várias partes, adicione os valores de formulário a serem incluídos na solicitação e digite o nome e o valor de cada um. Se você adicionar valores de formulário, deixe em branco Content type.
Esquema de saída	Para permitir que comandos posteriores na cadeia acessem as propriedades de saída desse comando, insira uma carga útil de amostra para cada saída JSON.

Saídas

Saída	Tipo de saída
Cabeçalhos de resposta	JSON
Resposta	Arquivo
Código de resposta	Inteiro

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
2	Erro	Falha na solicitação; código de resposta não-200
4	Erro	O certificado não foi encontrado
5	Erro	Cabeçalhos de solicitação inválidos

Colocar

Para alterar ou atualizar um recurso, use o comando Put. Esse comando faz uma solicitação HTTP PUT, como https://postman-echo.com/put.

Propriedades

Propriedade	Detalhes
Nome de usuário	Se a autenticação básica for necessária, digite o nome de usuário.
Senha	Se a autenticação básica for necessária, digite a senha.
Certificado CA	Digite o certificado de CA a ser usado ao fazer a solicitação (opcional).
Certificado	Digite o certificado a ser enviado com a solicitação (opcional). Se fornecido, insira também Chave privada do certificado.
Chave privada do certificado	Digite a chave privada para Certificado, se fornecido.
Mostrar resposta	Para mostrar o corpo da resposta da API na saída, marque essa caixa.
URL	Digite o URL usado para a solicitação.
Tipo de conteúdo	Digite o cabeçalho do tipo de conteúdo a ser definido. Isso especifica o formato esperado a ser enviado para o corpo da solicitação. Observação: Para dados com várias partes, adicione Valores de formulário para gerar o corpo.
Arquivo de corpo	Digite o arquivo que contém o objeto JSON ou os parâmetros da solicitação a serem enviados no corpo da solicitação. Se você incluir isso, deixe Body text em branco.
Texto do corpo	Digite o texto a ser enviado no corpo da solicitação. Se você incluir isso, deixe em branco Body file.
Headers	Digite os cabeçalhos adicionais a serem adicionados à solicitação.
Valores do formulário	Para gerar o corpo para dados de várias partes, adicione os valores de formulário a serem incluídos na solicitação e digite o nome e o valor de cada um. Se você adicionar valores de formulário, deixe em branco Content type.
Esquema de saída	Para permitir que comandos posteriores na cadeia acessem as propriedades de saída desse comando, insira uma carga útil de amostra para cada saída JSON.

Saídas

Saída	Tipo de saída
Cabeçalhos de resposta	JSON
Resposta	Arquivo
Código de resposta	Inteiro

Códigos de saída

Código	Tipo	Detalhes
0	Sucesso	Sucesso
2	Erro	Falha na solicitação; código de resposta não-200
4	Erro	O certificado não foi encontrado
5	Erro	Cabeçalhos de solicitação inválidos

Suporte

Comunidade

Centro de suporte da Workiva