Descrição
| Integração. Requisição de informação web. HTTP |
Sintaxe
| Httpquote( < cUrl >, < cMethod >, [ cGETParms ], [ cPOSTParms ], [ nTimeOut ], [ aHeadStr ], [ @cHeaderRet ] ) |
Parâmetros
| Par | Nome | Tipo | Descrição | Default | Obg | Ref |
|---|---|---|---|---|---|---|
| 01 | cUrl | caractere | Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados | X | ||
| 02 | cMethod | caractere | Define o HTTP Method que será utilizado, permitindo outros além de POST/GET | X | ||
| 03 | cGETParms | caractere | Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados | |||
| 04 | 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 ("") | |||
| 05 | 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 | |||
| 06 | aHeadStr | array | Permite especificar um array com strings a serem acrescentadas ao Header da requisição HTTP a ser realizada | |||
| 07 | 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
| Retorno | Tipo | Descrição |
| cResponse | Character | Retorna a string correspondendo ao documento solicitado |
Exemplo
#INCLUDE "TOTVS.CH"
User Function HTTPQuote()
Local cRoute := 'xxxxx') as character
Local cRespJSON := '' as character
Local cHeaderRet := '' as character
Local cRetResponse := '' as character
cRespJSON := HTTPQuote(cRoute, "GET", "", , , Self:aHeadStr, @cHeaderRet)
cRespJSON := DecodeUTF8(cRespJSON)
If !Empty(cRespJSON) .AND. At('200 OK',cHeaderRet) > 0
Endif
Return( Nil )
Resultado
Informação Adicional
|
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 |
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎