Função: HTTPQuote
Permite a emulação de 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, permitindo a passagem de parâmetros adicionais via URL e aguardando por um tempo determinado (time-out) pela resposta do servidor solicitado.
HTTPQuote ( < cUrl>, < cMethod>, [ cGETParms], [ cPOSTParms], [ nTimeOut], [ aHeadStr], [ @cHeaderRet] ) --> cResponse
| Nome | Tipo | Descrição | Obrigatório | Referência |
| cUrl | Caracter | cUrl corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | X | |
| cMethod | Caracter | Define o HTTP Method que será utilizado, permitindo outros além de POST/GET. | X | |
| cGETParms | Caracter | cUrl corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | ||
| cPOSTParms | Caracter | cPostParms 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 | Em nTimeOut 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 | Vetor | Através deste parâmetro, podemos especificar um array com strings a serem acrescentadas ao Header da requisição HTTP a ser realizada. | ||
| cHeaderRet | Caracter | 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. | X |
-
cResponse(caracter)
- Através de cResponse será retornada a String correspondendo ao documento solicitado.
- 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 html 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'.
Microsiga Protheus 8.11
,
TOTVS Application Server 10