|
|
|
|
|
|
|
|
|
|
- Notes
- Security error in a secure transaction
- Required permissions
HTTPSend (Function) In french: HTTPEnvoie Sends an HTTP request and waits for the response from the HTTP server. 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 with an httpRequest variable Hide the details
<HTTP response> = HTTPSend(<HTTP request>)
<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.
Simplified syntax for sending a request Hide the details
<HTTP response> = HTTPSend(<URL>)
<HTTP response>: httpResponse variable Name of the httpResponse variable containing the response received from the HTTP server. <URL>: Character string URL to interrogate. Remarks Notes - To find out what errors have occurred in the execution of this function:
- If the server you have contacted cannot be reached, use ErrorOccurred and ErrorInfo..
- If the server can be contacted, use the CodeEtat property of variable type httpResponse to find out the response (by default, 200 indicates that the request has been accepted; any error will be detailed by another HTTP code).
- If cookie management is set up for the specified request (function HTTPCookieManage), after calling function HTTPSend the cookies received are updated in variable httpRequest.. Therefore, during the next call to HTTPSend 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.
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.
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 name of the site 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. | | httpIgnoreDeprecated | Ignores errors related to the use of deprecated algorithms (e.g. SHA-1 certificate signature). | 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. | | httpIgnoreUnsafeRenegotiation | Ignores the error stating that the server does not support secure renegotiation (RFC 5746). | | 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 handled: httpIgnoreCertificateExpired, httpIgnoreCertificatInvalid, httpIgnoreCertificateNameInvalid, httpIgnoreRevocation, httpIgnoreRedirection.
Business / UI classification: Business Logic
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|