ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / HTTP functions
  • Notes
  • Security error in a secure transaction
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Sends an HTTP request. Two modes are available
  • send HTTP request and wait for server response (blocking mode).
  • send request without waiting for server response (asynchronous mode). The response will be processed by a WLanguage procedure.
Syntax

Syntax using an httpRequest variable Hide the details

<HTTP response> = <HTTP request>.Send()
<HTTP response>: httpResponse variable
Name of the httpResponse variable containing the response received from the HTTP server.
<HTTP request>: httpRequest variable
Name of the httpRequest variable that contains the characteristics of the HTTP request to be sent to the server.
WEBDEV - Browser code

Asynchronous syntax using an httpRequest variable Hide the details

Send(<HTTP request> , <WLanguage procedure>)
<HTTP request>: httpRequest variable
Name of the httpRequest variable that contains the characteristics of the HTTP request to be sent to the server.
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure called during the response from the HTTP server. For more details, see Parameters of the procedure used by <httpRequest variable>.Send.
Remarks

Notes

  • To identify the execution errors of this function:
    • If the server cannot be reached, use ErrorOccurred and ErrorInfo.
    • If the server can be reached, use the StatusCode property of the httpResponse variable to get the response. By default, 200 indicates that the request has been accepted. Other HTTP codes will indicate errors, if any.
  • If cookies have been implemented for the specified request (<httpRequest variable>.ManageCookie), they are updated in the httpRequest variable after the call to <httpRequest variable>.Send. Therefore, during the next call to <httpRequest variable>.Send with this request, the cookies will be taken into account.
  • From version 21, redirections are automatically taken into account in HTTP requests. To manually process redirections in HTTP requests, you must use the IgnoreError property of the httpRequest variable with the httpIgnoreRedirection constant.
  • WEBDEV - Browser code Access to REST APIs from a domain other than the one hosting the site from a browser code (Cross-domain) is blocked by default (Cross-Origin Request Blocked). To allow this access, specific authorizations must be configured on the web server. This topic is covered in the following post on the support blog: https://blogs.pcsoft.fr/fr/autoriser-acces-api-rest-domaine-cors

Security error in a secure transaction

During a secure transaction, the request may fail due to security errors:
  • invalid certificate or certificate issued by an unknown organization.
  • the site name 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 run the request again, ignoring the errors. To do so, simply modify the IgnoreError property of the httpRequest variable:
Error returned by ErrorInfo
(with the errCode constant)
Value of the IgnoreError property of the httpRequest variable
(these values can be combined)
Description
httpErrorInvalidCertificate
Invalid certificate or certificate issued by an unknown organization.
httpIgnoreInvalidCertificateIgnores the certificate.
httpErrorInvalidCertificateName
The site name specified in the certificate does not correspond to a server.
httpIgnoreInvalidCertificateNameIgnores the site name specified in the certificate.
httpErrorExpiredCertificate
Invalid or expired certificate date.
httpIgnoreExpiredCertificateIgnores the certificate date.
httpIgnoreDeprecatedIgnores errors related to the use of deprecated algorithms (e.g. SHA-1 certificate signature).
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.
httpIgnoreUnsafeRenegotiationIgnores the error indicating that the server does not support secure renegotiation (RFC 5746).
httpIgnoreRevocationThe certificate is not verified in the list of revoked certificates.

Remarks:
  • When the HTTP queries are run in several threads, the HTTP.IgnoreError variable has a specific value for each thread.
Component: wd300com.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/16/2025

Send a report | Local help