Bloco de Função HTTP_REQUEST
O bloco de função HTTP_REQUEST cria uma consulta RAW para a interface HTTP.
Importante: A variável a ser enviada pela interface HTTP deve ter o tipo de dados RAW.
A URI é definida como uma variável no lado direito sob Comunicação. Se começar com um /, o primeiro / será removido. Para fazer uma solicitação ao diretório mais baixo, apenas a variável / pode ser definida.
Alguns servidores web exigem o cabeçalho User-Agent. Caso contrário, a página não será carregada. Isso não é um erro do Antcas Control, mas um mecanismo de proteção do navegador da web solicitado. Use a entrada Header com o seguinte conteúdo:
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13
Entrada Method
A entrada define o método de transferência como uma string. Pode ser, por exemplo, "GET", "POST", "PUT" ou outros. Se nenhum método for definido, GET será escolhido como padrão.
Entrada Type
A entrada define o cabeçalho Content-Type como uma string. Se a entrada não estiver definida, a entrada não será adicionada ao cabeçalho.
Entrada Header
Define entradas de cabeçalho adicionais como uma string. Vários cabeçalhos são separados por uma quebra de linha. O cabeçalho Content-Length é definido automaticamente e o cabeçalho Content-Type é definido com o valor na entrada Type.
Entrada Query
A entrada define a consulta como uma string. A consulta é o valor após o ponto de interrogação e geralmente é usada em solicitações GET.
http://server/uri?query
A estrutura de uma consulta é a seguinte:
var1=wert1&var2=wert2&va...
Para que os valores possam ser transferidos corretamente, é recomendável codificar os valores individuais com o bloco de função URL_ENCODE ou QUERY_ENCODE, pois os dados podem não ser transferidos completamente.
Aviso: Observe o comprimento máximo de uma URL, caso seja necessário transferir grandes volumes de dados. Use, se necessário, o método POST e envie a consulta como Content.
Entrada Content
A entrada Content é semelhante à da entrada Query. No entanto, os dados são transferidos após o cabeçalho e são suportados maiores volumes de dados. Dependendo da aplicação, o tipo de Content também pode não ter um método de consulta.
Aviso: Apenas dados conformes com UTF-8 são suportados. Ao transferir dados binários, recomenda-se codificá-los com o bloco de função BASE64_ENCODE.
Entrada Timeout
A entrada define o tempo limite da solicitação como tempo no formato T#30s em segundos. Recomenda-se usar um tempo limite alto. Valores pequenos podem levar a solicitações não sendo completamente executadas. Devido ao procedimento Keep-Alive, pode levar algum tempo até que as solicitações sejam processadas normalmente novamente.
Entrada DIS
Se a entrada for verdadeira, o valor na saída Request será igual a NULL.
Entrada SET
Se a entrada for verdadeira, ela força a geração da saída Request. Esta entrada tem prioridade sobre a entrada DIS.
Saída Request
A saída retorna uma string no formato JSON. Se estiver desativada, o valor NULL será retornado. Geralmente é conectado diretamente à variável de saída da interface.
Saída Length
A saída retorna o comprimento da entrada Content em bytes.
Saída ID
Retorna a ID da última consulta gerada. Isso é útil para verificar a resposta com o bloco de função HTTP_RESPONSE.