PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Notes
  • Security error in a secure transaction
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Sends an HTTP request and waits for the response from the HTTP server.
Versions 22 and later
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
WEBDEV - Browser code This function is now available in browser code.
New in version 22
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
WEBDEV - Browser code This function is now available in browser code.
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
WEBDEV - Browser code This function is now available in browser code.
Example
cMyRequest is httpRequest
cMyRequest..URL = "http://www.windev.com"
cMyResponse is httpResponse = HTTPSend(cMyRequest)
IF ErrorOccurred THEN
Error(ErrorInfo(errFullDetails))
ELSE
Info(cMyResponse..Content)
END
Syntax

Syntax that is using an httpRequest variable Hide the details

<HTTP Response> = HTTPSend(<HTTP request>)
<HTTP Response>: httpResponse variable
Name of httpResponse variable containing the response received from the HTTP server.
<HTTP request>: httpRequest variable
Name of httpRequest variable containing the characteristics of the HTTP request that will be sent to the server.

Simplified syntax for sending a request Hide the details

<HTTP Response> = HTTPSend(<URL>)
<HTTP Response>: httpResponse variable
Name of httpResponse variable containing the response received from the HTTP server.
<URL>: Character string (with quotes)
URL to interrogate.
Versions 22 and later
WEBDEV - Browser code

Asynchronous syntax that is using an httpRequest variable Hide the details

HTTPSend(<HTTP request> , <WLanguage Procedure>)
<HTTP request>: httpRequest variable
Name of httpRequest variable containing the characteristics of the HTTP request that will be sent to the server.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
New in version 22
WEBDEV - Browser code

Asynchronous syntax that is using an httpRequest variable Hide the details

HTTPSend(<HTTP request> , <WLanguage Procedure>)
<HTTP request>: httpRequest variable
Name of httpRequest variable containing the characteristics of the HTTP request that will be sent to the server.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
WEBDEV - Browser code

Asynchronous syntax that is using an httpRequest variable Hide the details

HTTPSend(<HTTP request> , <WLanguage Procedure>)
<HTTP request>: httpRequest variable
Name of httpRequest variable containing the characteristics of the HTTP request that will be sent to the server.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
Versions 22 and later
WEBDEV - Browser code

Simplified asynchronous syntax for sending a request Hide the details

HTTPSend(<URL> , <WLanguage Procedure>)
<URL>: Character string (with quotes)
URL to interrogate.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
New in version 22
WEBDEV - Browser code

Simplified asynchronous syntax for sending a request Hide the details

HTTPSend(<URL> , <WLanguage Procedure>)
<URL>: Character string (with quotes)
URL to interrogate.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
WEBDEV - Browser code

Simplified asynchronous syntax for sending a request Hide the details

HTTPSend(<URL> , <WLanguage Procedure>)
<URL>: Character string (with quotes)
URL to interrogate.
<WLanguage Procedure>: Character string
Name of WLanguage procedure called during the response from the HTTP server. This procedure has the following format:
PROCEDURE <Procedure Name>(<Response> is httpResponse)
where <Response> is an httpResponse variable containing the response received from the HTTP server.
Remarks

Notes

  • To find out the runtime errors of this function, use ErrorOccurred and ErrorInfo.
  • If the management of cookies is implemented for the specified request (HTTPCookieManage), the cookies are updated in the httpRequestvariable after the call to HTTPSend. Therefore, during the next call to HTTPSend with this request, the cookies will be taken into account.
  • Versions 21 and later
    From version 21, the redirections are automatically taken into account in the HTTP requests. To manually process the redirections in the HTTP requests, you must use ..IgnoreErrr of httpRequest variable associated with the httpIgnoreRedirection constant.
    New in version 21
    From version 21, the redirections are automatically taken into account in the HTTP requests. To manually process the redirections in the HTTP requests, you must use ..IgnoreErrr of httpRequest variable associated with the httpIgnoreRedirection constant.
    From version 21, the redirections are automatically taken into account in the HTTP requests. To manually process the redirections in the HTTP requests, you must use ..IgnoreErrr of httpRequest variable associated with the httpIgnoreRedirection constant.
  • AndroidAndroid Widget This function is available for the devices equipped with ARM processors. A fatal error occurs if this function is used with devices not equipped with ARM processors (x86, mips, ...). This function is available for the devices equipped with ARM processors or using an ARM emulation. Otherwise (and on the Samsung Galaxy Tab 3 tablet), a fatal error will occur.

Security error in a secure transaction

During a secure transaction, the request may fail due to security errors:
  • invalid certificate or certificate coming from an unknown company.
  • the name of the site specified in the certificate does not correspond to a server.
  • invalid or expired certificate date.
  • redirection to a non-secure server.
These errors are returned by ErrorInfo.
If one of these errors occurs, you can re-run the request while ignoring the errors. To do so, all you have to do is modify the ..IgnoreError property of httpRequest variable:
Error returned by ErrorInfo
(with the errCode constant)
Value of ..IgnoreError property of httpRequest variable
(these values can be combined)
Description
httpErrorInvalidCertificate
Invalid certificate or certificate coming from an unknown company
httpIgnoreInvalidCertificateThe certificate is ignored.
httpErrorInvalidCertificateName
The site name specified in the certificate does not correspond to a server
httpIgnoreInvalidCertificateNameThe site name specified in the certificate is ignored.
httpErrorExpiredCertificate
Invalid or expired certificate date
httpIgnoreExpiredCertificateThe certificate date is ignored
httpErrorRedirectToHTTP
Redirection to a non-secure server
httpIgnoreRedirectToHTTPThe redirection to a non-secure server is allowed.
httpIgnoreRedirectToHTTPS
Redirection to a secure server
httpIgnoreRedirectToHTTPSThe redirection to a secure server is allowed.
httpIgnoreRevocationThe certificate found in the list of revoked certificates is not checked.
Notes:
  • When the HTTP queries are run in several threads, the HTTP.IgnoreError variable has a specific value for each thread.
  • Versions 22 and later
    AndroidAndroid Widget The following errors are supported: httpIgnoreExpiredCertificate, httpIgnoreInvalidCertificate, httpIgnoreInvalidCertificateName, httpIgnoreRevocation, httpIgnoreRedirection.
    New in version 22
    AndroidAndroid Widget The following errors are supported: httpIgnoreExpiredCertificate, httpIgnoreInvalidCertificate, httpIgnoreInvalidCertificateName, httpIgnoreRevocation, httpIgnoreRedirection.
    AndroidAndroid Widget The following errors are supported: httpIgnoreExpiredCertificate, httpIgnoreInvalidCertificate, httpIgnoreInvalidCertificateName, httpIgnoreRevocation, httpIgnoreRedirection.
Versions 22 and later
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: INTERNET.
This permission allows the applications to open the network sockets.
New in version 22
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: INTERNET.
This permission allows the applications to open the network sockets.
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: INTERNET.
This permission allows the applications to open the network sockets.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230com.dll
WEBDEV - Browser code WDJS.DLL
Linux wd230com.so
Android wd230android.jar
Minimum required version
  • Version 20
This page is also available for…
Comments
Click [Add] to post a comment