|
Os tipos de arquivos clássicos não estarão mais disponíveis para uso a partir de janeiro de 2021. Você pode fazer a transição de seus arquivos clássicos ou baixar um PDF. Saber mais

Centro de suporte da Workiva

Comandos de solicitação HTTP

Comandos de solicitação HTTP

  • Última atualização em

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

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

Observação: 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 de OData, você pode adicionar os componentes necessários da requisição por meio dos parâmetros Cabeçalhos ou String de consulta.
  • Para habilitar a autenticação mútua TLS (mTLS), forneça um par de chaves pública/privada e, opcionalmente, um certificado CA. Para usar as chaves pública e privada, carregue-as como recursos do espaço de trabalho e selecione-as para os parâmetros Certificado e Chave privada do certificado do comando, respectivamente.
  • O arquivo contendo a chave privada não deve estar criptografado. Carregar um arquivo criptografado como chave privada resultará em um erro.

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

Excluir

Para remover um recurso, use um comando Excluir. Este comando faz uma requisiçã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 Insira o certificado a ser enviado com a requisiçã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 Insira o arquivo que contém o objeto JSON ou os parâmetros da requisição a serem enviados no corpo da requisição. Se você incluir isso, deixe Body text em branco.
Texto do corpo Insira o texto a ser enviado no corpo da requisição. Se você incluir isso, deixe em branco Body file.
Cabeçalhos 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

Obter

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

Observação: Este comando inclui um espaço para inserir parâmetros de consulta — os parâmetros não devem ser incluídos na própria URL. Se os parâmetros forem inseridos tanto na URL quanto no campo "String de consulta", eles serão removidos da 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 Insira o certificado a ser enviado com a requisiçã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.
String de consulta

Insira a string de consulta a ser acrescentada à requisição, como foo1=bar1&foo2=bar2.

Observação: A string de consulta deve ser codificada.
Cabeçalhos 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 requisiçã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 publicar um recurso, use um comando Postar. Este comando faz uma requisiçã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 Insira o certificado a ser enviado com a requisiçã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 requisição.

Observação: Para dados com várias partes, adicione Valores de formulário para gerar o corpo.
Arquivo do corpo Insira o arquivo que contém o objeto JSON ou os parâmetros da requisição a serem enviados no corpo da requisição. Se você incluir isso, deixe Body text em branco.
Texto do corpo

Insira o texto a ser enviado no corpo da requisição. Se você incluir isso, deixe Arquivo do corpo em branco.
Dica: se houver parâmetros de seleção múltipla, use o seguinte padrão:

{ "queryId": "YOUR_QUERY_ID", "parameters": { "yourParamName": ["value1", "value2"] } }
Cabeçalhos 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 do formulário a incluir na requisição e insira o nome e o valor para 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

Put

Para alterar ou atualizar um recurso, use um comando Put. Este comando faz uma requisiçã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 Insira o certificado a ser enviado com a requisiçã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 requisição.

Observação: Para dados com várias partes, adicione Valores de formulário para gerar o corpo.
Arquivo do corpo Insira o arquivo que contém o objeto JSON ou os parâmetros da requisição a serem enviados no corpo da requisição. Se você incluir isso, deixe Body text em branco.
Texto do corpo Insira o texto a ser enviado no corpo da requisição. Se você incluir isso, deixe em branco Body file.
Cabeçalhos 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 do formulário a incluir na requisição e insira o nome e o valor para 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
Esse artigo foi útil?
Usuários que acharam isso útil: 2 de 8
Uma conexão de requisições HTTP executa esses comandos para realizar requisições comuns de HyperText Transfer Protoco...