<httpRequest variable>.Send (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

HTTP functions

Prefix syntax

Send

Presentation

Notes

Security error in a secure transaction

Required permissions

See also

<httpRequest variable>.Send (Function)

In french: <Variable httpRequête>.Envoie

Sends an HTTP request and waits for the response from the HTTP server.

Syntax

Syntax with an httpRequest variable Hide the details

<HTTP response> = <HTTP request>.Sends()

<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.

Asynchronous syntax with an httpRequest variable Hide the details

Sends(<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. 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 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, the redirections are automatically taken into account in the HTTP requests. To manually process redirections in HTTP requests, you must use the IgnoreError property of the httpRequest variable with the httpIgnoreRedirection constant.
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 avoid being blocked, 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 coming from an unknown company.
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 re-run the request while 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 coming from an unknown company	httpIgnoreInvalidCertificate	The certificate is ignored.
httpErrorInvalidCertificateName The site name specified in the certificate does not correspond to a server	httpIgnoreInvalidCertificateName	The site name specified in the certificate is ignored.
httpErrorExpiredCertificate Invalid or expired certificate date	httpIgnoreExpiredCertificate	The certificate date is ignored
httpErrorRedirectToHTTP Redirection to a non-secure server	httpIgnoreRedirectToHTTP	The redirection to a non-secure server is allowed.
httpIgnoreRedirectToHTTPS Redirection to a secure server	httpIgnoreRedirectToHTTPS	The redirection to a secure server is allowed.
	httpIgnoreRevocation	The certificate found in the list of revoked certificates is not checked.

Remarks:

When the HTTP queries are run in several threads, the HTTP.IgnoreError variable has a specific value for each thread.
The following errors are supported: httpIgnoreExpiredCertificate, httpIgnoreInvalidCertificate, httpIgnoreInvalidCertificateName, httpIgnoreRevocation, httpIgnoreRedirection.

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.

Component: wd280com.dll