DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions HTTP
  • Notes
  • Erreur de sécurité dans une transaction sécurisée
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Envoie une requête HTTP et attend la réponse du serveur HTTP.
Exemple
cMaRequête est un httpRequête
cMaRequête.URL = "http://www.pcsoft.fr"
cMaRéponse est un httpRéponse = HTTPEnvoie(cMaRequête)
SI ErreurDétectée ALORS
Erreur(ErreurInfo(errComplet))
SINON
Info(cMaRéponse.Contenu)
FIN
Syntaxe

Syntaxe utilisant une variable de type httpRequête Masquer les détails

<Réponse HTTP> = HTTPEnvoie(<Requête HTTP>)
<Réponse HTTP> : Variable de type httpRéponse
Nom de la variable de type httpRéponse contenant la réponse reçue du serveur HTTP.
<Requête HTTP> : Variable de type httpRequête
Nom de la variable de type httpRequête contenant les caractéristiques de la requête HTTP à envoyer au serveur.

Syntaxe simplifiée d'envoi d'une requête Masquer les détails

<Réponse HTTP> = HTTPEnvoie(<URL>)
<Réponse HTTP> : Variable de type httpRéponse
Nom de la variable de type httpRéponse contenant la réponse reçue du serveur HTTP.
<URL> : Chaîne de caractères
URL à interroger.
WINDEV

Syntaxe asynchrone utilisant une variable de type httpRequête Masquer les détails

HTTPEnvoie(<Requête HTTP> , <Procédure WLangage>)
<Requête HTTP> : Variable de type httpRequête
Nom de la variable de type httpRequête contenant les caractéristiques de la requête HTTP à envoyer au serveur.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage appelée lors de la réponse du serveur HTTP. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Réponse> est une httpRéponse)
où <Réponse> est une variable de type httpRéponse contenant la réponse reçue du serveur HTTP.
WINDEV

Syntaxe asynchrone simplifiée d'envoi d'une requête Masquer les détails

HTTPEnvoie(<URL> , <Procédure WLangage>)
<URL> : Chaîne de caractères
URL à interroger.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage appelée lors de la réponse du serveur HTTP. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Réponse> est une httpRéponse)
où <Réponse> est une variable de type httpRéponse contenant la réponse reçue du serveur HTTP.
Remarques

Notes

  • Pour connaître les erreurs d'exécution de cette fonction, utilisez les fonctions ErreurDétectée et ErreurInfo.
  • Si la gestion des cookies est mise en place pour la requête spécifiée (fonction HTTPCookieGère), après l'appel de la fonction HTTPEnvoie les cookies reçus sont mis à jour dans la variable httpRequête. Ainsi, lors du prochain appel de la fonction HTTPEnvoie avec cette requête, les cookies seront pris en compte.
  • A partir de la version 21, les redirections dans les requêtes HTTP sont automatiquement prises en compte. Pour traiter manuellement les redirections dans les requêtes HTTP, il est nécessaire d'utiliser la propriété IgnoreErreur de la variable de type httpRequête avec la constante httpIgnoreRedirection.

Erreur de sécurité dans une transaction sécurisée

Lors d'une transaction sécurisée, certaines erreurs de sécurité peuvent faire échouer la requête :
  • certificat invalide ou ne provenant pas d'une société connue.
  • nom du site figurant dans le certificat ne correspond pas à un serveur.
  • date du certificat non-valide ou expiré.
  • renvoi vers un serveur non sécurisé.
Ces erreurs sont renvoyées par la fonction ErreurInfo.
Si une de ces erreurs est rencontrée, il est possible d'exécuter à nouveau la requête en ignorant ces erreurs. Pour cela, il suffit de modifier la propriété IgnoreErreur de la variable de type httpRequête :
Erreur renvoyée par la fonction ErreurInfo
(avec la constante errCode)
Valeur de la propriété IgnoreErreur de la variable de type httpRequête
(ces valeurs peuvent être combinées)
Description
httpErreurCertificatInvalide
Certificat invalide ou ne provenant pas d'une société connue
httpIgnoreCertificatInvalideLe certificat est ignoré.
httpErreurNomCertificatInvalide
Nom du site figurant dans le certificat ne correspond pas à un serveur
httpIgnoreNomCertificatInvalideLe nom du site figurant dans le certificat est ignoré.
httpErreurCertificatExpiré
Date du certificat non-valide ou expiré
httpIgnoreCertificatExpiréLa date du certificat est ignorée
httpErreurRenvoiHTTP
Renvoi vers un serveur non sécurisé
httpIgnoreRenvoiHTTPLe renvoi vers un serveur non sécurisé est autorisé.
httpErreurRenvoiHTTPS
Renvoi vers un serveur sécurisé
httpIgnoreRenvoiHTTPSLe renvoi vers un serveur sécurisé est autorisé.
httpIgnoreRévocationLe contrôle du certificat dans la liste des certificats révoqués n'est pas effectué.
Remarques :
  • Lorsque des requêtes HTTP sont faites dans plusieurs threads, la variable HTTP.IgnoreErreur possède une valeur spécifique par thread.
Classification Métier / UI : Code métier
Composante : wd290com.dll
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale