httpRequest (Variable type)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / HTTP functions

Properties specific to httpRequest variables
Remark
HTTP cookies

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

httpRequest (Variable type)

In french: httpRequête

The httpRequest type is used to retrieve the advanced characteristics of an HTTP/HTTPS request. You can define and change the characteristics of this HTTP/HTTPS request using different WLanguage properties.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

New in SaaS

This type of variable can now be used in User macro codes.
Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 3.
For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.

Example

cMaRequête is httpRequest
cMaRequête.URL = "https://www.pcsoft.fr"
cMaRéponse is httpResponse = HTTPSend(cMaRequête)
IF ErrorOccurred THEN 
	Error(ErrorInfo(errFullDetails))
ELSE
	Info(cMaRéponse.Content)
END

Properties

Properties specific to httpRequest variables

The following properties can be used to handle an HTTP/HTTPS request:

Property name	Type used	Effect

Authentication	Integer constant	Defines the authentication method required to access resources in a given server or website: auBasic: The name and password are in clear text in the request.. auDigest The name and password present in the request are modified via a hash. auNegotiate Client and server exchange a certain amount of information before establishing a connection. Kerberos is the default authentication protocol. If it is not available, the NTLM protocol is used. toNTLM The client and server exchange a certain amount of information before establishing a connection via the NTLM protocol (Windows only). Note: Although still widely used, the NTLM protocol is no longer recommended. Not available.
AuthToken	AuthToken variable	Token for accessing a web service that will be used in case of authentication via the OAuth 2.0 protocol. This access token is retrieved by AuthIdentify. The access token is automatically passed to the access_token parameter on the URL. If the parameter must be different, the http URL to run must be built by yourself. Not available.
ClientCertificate	String or buffer	Corresponds to: a character string with an access path to the .p12 file that contains the certificate to attach to the request. The certificate will be automatically loaded taking into account: the certificate in the executable library (if it has been integrated into the application), the certificate at the specified location on disk (if the certificate has not been integrated into the executable library). a buffer with the certificate (fLoadBuffer). If this property is set to an empty string (""), the default certificate is reset to "<None>".
ClientCertificatePassword	Character string or Secret string	Password associated with the client certificate (empty string by default). New in version 2025 Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI string - Latin". To learn more about secret strings and how to use the vault, see Secret string vault.
ConnectionTimeout	Integer or Duration	Maximum timeout for the connection expressed in milliseconds (20 seconds by default, i.e. 20000 milliseconds). This property can correspond to: an integer representing the number of milliseconds, a Duration variable, the duration in a readable format (e.g., 20 s or 20000 ms). The connection fails if it cannot be established after this timeout (HTTPSend will return an error, in the httpResponse result variable). Not available.
Content	Buffer	HTTP message that will be sent to the server. This property is taken into account only if the sending method (Method property) allows it. The message to send must comply with the HTTP protocol used. By default, if this property is specified and if it is not empty, the method used is a POST request ; otherwise, it is a GET request.
ContentType	Character string	Type of the HTTP message content to be sent to the server. This property is taken into account only if the sending method (Method property) allows it. The default message type is: "application/x-www-form-urlencoded". However, it is possible to enter any value, for example: "text/xml", "application/javascript", "application/json", "application/xml", "image/jpeg", ... To send raw data, which will be read at once by the WEBDEV Application Server, use the following types: "application/octet-stream". "text/xml".
Destination	Character string	Full path of the backup file of the HTTP request result. Not available.
DownloadProgress	httpProgress variable	Data reception progress notification.
Header	Associative array of strings	Key/Value set of headers to send. Usage example of this property: `cMaRequête.Entête["Authorization"] = ... " WSSE profile=""UsernameToken""" cMaRequête.Entête["X-WSSE"] = ... "UsernameToken Username=blahblah " cMaRequête.Entête["Cache-Control"] = " no-cache"` Behavior change from version 29 Update 3: Prior to version 29 Update 3, empty headers are not transmitted.. From version 29 Update 3empty headers are transmitted. Example: `req is httpRequest req.Header["Vide"] = "" req.Send()` Now the "Empty" header is passed to the server when the request is sent, and its value is an empty string.
IgnoreError	Integer constant	Specifies the ignored errors. Corresponds to a constant or to a combination of constants: httpIgnoreCertificateInvalid The certificate is ignored. httpIgnoreCertificateNameInvalid: The site name in the certificate is ignored. httpIgnoreCertificateExpired Certificate date is ignored. httpIgnoreDeprecated Ignore errors related to the use of deprecated algorithms (e.g. SHA-1 certificate signature). httpIgnoreRedirection: Redirection to a page is ignored. httpIgnoreRenvoiHTTP: Forwarding to a non-secure server is allowed. httpIgnoreRenvoiHTTPS: Forwarding to a secure server is allowed. httpIgnoreNonSecureNegotiation Ignore the error stating that the server does not support secure renegotiation (RFC 5746). httpIgnoreRevocation: The check in the list of revoked certificates is ignored. Only the following errors are handled: httpIgnoreCertificateExpired, httpIgnoreCertificatInvalid, httpIgnoreCertificateNameInvalid, httpIgnoreRevocation, httpIgnoreRedirection. Not available.
MaxDownloadRate	entier	\| Maximum data download speed in kilobytes per second. This speed is given for information only. 0 (default value) means that this speed is not limited. Not available.
MaxUploadRate	entier	Maximum data upload speed in kilobytes per second. This speed is given for information only. 0 (default value) means that this speed is not limited. Not available.
Method	Integer constant	HTTP method used: httpCopy COPY method (value 7). httpDelete DELETE method (value 4). httpGet GET method (value 1). httpHead HEAD method (value 5). httpLock LOCK method (value 12) (WebDAV protocol). httpMkCol MKCOL method (value 10) (WebDAV protocol). httpMove MOVE method (value 11) (WebDAV protocol). httpPatch PATCH method (value 6). httpPost POST method (value 2). httpPropFind PROPFIND method (value 8) (WebDAV protocol). httpPropPatch PROPPATCH method (value 9) (WebDAV protocol). httpPut PUT method (value 3). httpUnlock UNLOCK method (value 13) (WebDAV protocol). If the Content property is not empty, the httpPost method is used by default. Otherwise, the httpGet method is used.
Password	Character string or Secret string	Password associated with the username (empty string by default). Used to access a page with a protected URL. Caution: The password is transmitted unencrypted over the Internet. Note: By setting the UserName and Passwordproperties, the corresponding "Authorization:Basic" is automatically generated in the request header. New in version 2025 Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string". To learn more about secret strings and how to use the vault, see Secret string vault.
New in SaaS ProcedureData	Procedure	Name of WLanguage procedure called as data is received. This procedure can be used to progressively retrieve a response to an HTTP request, for example when the server returns a chunked response or simply a large response. This procedure has the following format: PROCEDURE <Nom procédure>(<Morceau> is a Buffer) where <Morceau> corresponds to the recovered data. If this procedure returns False, the request is cancelled as well as the data reception. Sample procedure: `PROCEDURE procDonnées(bufMorceau is Buffer) Trace("Je traite [%Taille(bufMorceau)%] octets de données") Trace(UTF8ToString(bufMorceau)) Trace("----------------------")` Not available. Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 3. For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.
New in SaaS ProcedureEntête	Procedure	Name of the WLanguage procedure to be called only if the request is successful (HTTP response code between 200 and 299). This procedure can be used when the server returns a chunked response or simply a large response. This procedure has the following format: PROCEDURE <Nom procédure>(<Réponse> is an httpResponse) where <réponse> corresponds to the advanced characteristics of the response to the request. Sample procedure: `PROCEDURE procEntete(cMonEntête is httpResponse) Trace("ProcédureEntête") IF 200 <= cMonEntête.StatusCode _AND_ cMonEntête.StatusCode <= 299 THEN Trace("OK") ELSE Trace("Erreur") END Trace(cMonEntête.RawHeader) Trace("----------------------")` Note: When redirecting, redirect headers do not trigger the. Not available. Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 3. For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.
ProcedureTrace	Procedure	Name of the WLanguage procedure used to identify the data and headers that have been sent and received. This procedure has the following format: PROCEDURE <Procedure name>(<InfoType> is int, <Data> is Buffer) where: <InfoType> is an integer constant that corresponds to the type of data being traced: httpTraceDataSent Data sent. httpTraceDataRecue: Received data. httpTraceEntêteEnvoyé Sent header. httpTraceEntêteRecu: Received header. httpTraceInfo Detailed information on request execution (low-level cURL/OpenSSL error, step in progress, warnings, etc.). <Data> is a buffer that contains the information. Procedure example: `PROCEDURE ProcTrace(nTypeInfo is int, ... bufByData is Buffer) SWITCH nTypeInfo CASE httpTraceHeaderSent: Trace("Entête : ", ... UTF8ToString(bufByData)) CASE httpTraceDataSent: Trace("Données : ", ... bufByData) CASE httpTraceHeaderReceived: Trace("Entête reçu : ", ... UTF8ToString(bufByData)) CASE httpTraceDataReceived: Trace("Données reçues : ", ... bufByData) END` Not available.
ResponseRawContent	Boolean	Indicates whether the Content property corresponds to the raw content: True: the Content property corresponds to a buffer. No modification is performed. False (Default): content is modified by the browser. In particular, UTF-8 text is automatically decoded. the Content property returns the result as a string.
SelectedCipher	Character string	Name of the cipher selected for the secure request. This property is available for playback only.
SelectedSSLVersion	Integer constant	SSL version chosen for a secure request: DefaultProtocol: Default protocol (TLS 1.2). TLS1 protocol: TLS1 protocol. TLS1_1 protocol: TLS1.1 protocol. TLS1_2 protocol: TLS1.2 protocol. TLS1_3 protocol: TLS1.3 protocol. Not available. This property is available for playback only.
Timeout	Integer or Duration	Maximum response timeout (in milliseconds). This property can correspond to: an integer representing the number of milliseconds, a Duration variable, the duration in a readable format (e.g., '1s' or '10ms'). This property is set to 20 seconds by default. Note: The timeout defined with function HTTPTimeOut has no influence on this property. Not available.
UploadProgress	httpProgress variable	Notification of the progress status when uploading POST data.
URL	Character string	Address of server to contact (URL address). This URL can contain: the port number for connecting to the server. The default value is 80 in HTTP (corresponds to a server of Web pages) and 443 in HTTPS. To specify a port number, use the format: "<Server URL>:<Port number>". For example: "http://www.pcsoft.fr:80". additional parameters. These parameters can be used to perform a search or to fill a form. For example, to search for "pcsoft" on "http://www.google.fr", the URL to contact would be: "http://www.google.fr/search?q=pcsoft". Remarks: To specify both the port number and additional parameters, use the format: "<Server URL>:<Port Number>/<Additional Parameters>". To perform a secure transaction, the URL must start with "https://". In this case, the management mode of requests is always performed by Internet Explorer (for more details, see HTTPConfigure).
User	Character string	Name used to access a page with a protected URL (empty string by default). This name is used to identify the user. Note: By entering the properties User and Password, the corresponding "Authorization:Basic" is automatically generated in the request header.
UserAgent	Character string	Identifies the client. By default, the value corresponds to the application name. The response content may depend on the user agent (for example, different pages are required by a request performed from a Palm Pilot and a request performed from a PC browser). In this case, for more details, see the documentation of user agent. Not available.
VersionHTTP	Integer constant	HTTP version used by the server: httpVersion2: HTTP 2.0. If the server does not support this version, an older version is used. httpVersion2Only: Forces HTTP 2.0. If the server does not support this version, a fatal error is displayed. httpVersion1_1: HTTP 1.1. httpVersion1_0: HTTP 1.0. httpVersionDefault: HTTP 1.0.
VersionSSL	Integer constant	Minimum and maximum SSL version supported. To set the minimum and maximum TLS versions to 1.1 and 1.3, simply specify the ProtocolTLS1_1 + ProtocolTLS1_3 constants The following constants can be used: Default protocol: Default protocol. Maximum version supported (or a lower version if the server does not support this protocol). TLS1 protocol: TLS1 protocol. TLS1_1 protocol: TLS1.1 protocol. TLS1_2 protocol: TLS1.2 protocol. TLS1_3 protocol: TLS1.3 protocol. Not available.

Remarks

Remark

Redirections are supported by default. To ignore redirections, use the httpIgnoreRedirection constant in the IgnoreError property.

HTTP cookies

Cookies received in response to a call to the HTTPSend function are stored pending a subsequent call to the HTTPSend function on the same domain: the variable of type httpRequest variable is updated.
For more details, see function HTTPCookieManage.