Permite emular um Client HTTP através de uma função AdvPL, no qual o método HTTP é informado para a função, postando um bloco de informações para um determinado documento publicado em um servidor Web.
Essa função viabiliza a passagem de parâmetros adicionais via URL, aguardando por um tempo determinado (time-out) pela resposta do servidor solicitado.
Sintaxe
HTTPQuote( < cUrl >, < cMethod >, [ cGETParms ], [ cPOSTParms ], [ nTimeOut ], [ aHeadStr ], [ @cHeaderRet ] )
Parâmetros
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| cUrl | caractere | Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | X |
| cMethod | caractere | Define o HTTP Method que será utilizado, permitindo outros além de POST/GET. | X |
| cGETParms | caractere | Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | |
| cPOSTParms | caractere | Corresponde à StringList de parâmetros a serem enviados ao servidor HTTP através do pacote HTTP. Caso não especificado, este parâmetro é considerado vazio ("") | |
| nTimeOut | numérico | Especificamos o tempo em segundos (máximo) de inatividade permitido durante a recepção do documento. Caso não especificado, o valor padrão assumido é 120 segundos (2 minutos). | |
| aHeadStr | array | Permite especificar um array com strings a serem acrescentadas ao Header da requisição HTTP a ser realizada. | |
| cHeaderRet | caractere | Retorna através de referência o header de resposta HTTP enviado pelo servidor requisitado. Variável deve ser declarada antes da chamada da função. |
Retorno
| Nome | Tipo | Descrição |
|---|---|---|
| cResponse | caractere | Retorna a string correspondendo ao documento solicitado. |
Observações
- Na passagem de parâmetros GET e POST, deve-se observar ao formato da string a ser passada como parâmetros, pois a mesma segue o formato URI (Uniform Resource Identifiers) : Query Component.
- Caso não seja retornado o documento antes do término do Time-out especificado na chamada da função, ou caso não seja possível localizar o servidor, seja por falha de resolução de DNS ou por erro de sintaxe ao especificar a URL, a função retornará Nulo (NIL).
- Caso não seja possível o acesso ao documento, como por exemplo o documento não exista, será retornado uma string HTML com a mensagem de erro enviada pelo servidor correspondente.
- Quando utilizamos a função HTTPQuote(), podemos especificar um Content-Type diferenciado para o conteúdo postado. Caso não seja especificado um Content-Type, alguns servidores tratam a informação postada como sendo um dado do tipo 'application/x-www-form-url', seria o equivalente a um formulário HTML postado via Browser. Outros servidores poderão não reconhecer tal informação postada dessa forma. Para especificar que o conteúdo postado deve ser tratado como um POST de formulário HTTP, devemos passar no parâmetro aHeadStr, um elemento contendo 'Content-Type: application/x-www-form-url'.
Visão Geral
Conteúdo das Ferramentas