4D v16.3

HTTP Request

Accueil

 
4D v16.3
HTTP Request

HTTP Request 


 

HTTP Request ( méthodeHTTP ; url ; contenu ; réponse {; nomsEnTêtes ; valeursEnTêtes}{; *} ) -> Résultat 
Paramètre Type   Description
méthodeHTTP  Texte in Méthode HTTP pour la requête
url  Texte in URL auquel envoyer la requête
contenu  Texte, BLOB, Image, Objet in Contenu du corps (body) de la requête
réponse  Texte, BLOB, Image, Objet in Résultat de la requête
nomsEnTêtes  Tableau texte in Noms des en-têtes de la requête
in Noms d’en-têtes retournés
valeursEnTêtes  Tableau texte in Valeurs d’en-têtes de la requête
in Valeurs d’en-têtes retournées
Opérateur in Si passé, la connexion est maintenue (keep-alive)
Si omis, la connexion est automatiquement refermée
Résultat  Entier long in Code de statut HTTP

La commande HTTP Request permet d’envoyer tout type de requête HTTP vers un URL spécifique et de traiter la réponse du serveur HTTP.

Passez dans le paramètre méthodeHTTP la méthode HTTP de la requête. Vous pouvez utiliser une des constantes suivantes, placées dans le thème Client HTTP :

Constante Type Valeur Comment
HTTP méthode DELETE Chaîne DELETE Voir la RFC 2616
HTTP méthode GET Chaîne GET Voir la RFC 2616. Equivaut à utiliser la commande HTTP Get
HTTP méthode HEAD Chaîne HEAD Voir la RFC 2616
HTTP méthode OPTIONS Chaîne OPTIONS Voir la RFC 2616
HTTP méthode POST Chaîne POST Voir la RFC 2616
HTTP méthode PUT Chaîne PUT Voir la RFC 2616
HTTP méthode TRACE Chaîne TRACE Voir la RFC 2616

Passez dans le paramètre url l’URL auquel adresser la requête. La syntaxe à utiliser est :

http://[{user}:[{password}]@]host[:{port}][/{path}][?{queryString}]

Par exemple, les chaînes suivantes peuvent être passées :

    http://www.myserver.com
    http://www.myserver.com/path
    http://www.myserver.com/path?name="jones"
    https://www.myserver.com/login (*)
    http://123.45.67.89:8083
    http://john:smith@123.45.67.89:8083

(*) Lors des requêtes https, l’autorité du certificat n’est pas vérifiée.

Passez dans le paramètre contenu le corps (body) de la requête. Les données à passer dans ce paramètre dépendent de la méthode HTTP de la requête.
Vous pouvez envoyer des données de type texte, BLOB, image ou objet. Lorsque le content-type n’est pas spécifié, les types suivants sont utilisés :

  • pour les textes : text/plain - UTF8
  • pour les BLOB : application/octet-stream
  • pour les images : type mime connu (best for Web)
  • pour les objets C_OBJET : application/json

Après exécution de la commande, le paramètre réponse récupère le résultat de la requête retourné par le serveur. Ce résultat correspond à la partie "corps" (body) de la réponse, sans les "en-têtes" (headers). Vous pouvez passer des variables de différents types dans réponse :

  • Texte : lorsque le résultat est attendu sous forme de texte (cf. note ci-dessous).
  • BLOB : lorsque le résultat est attendu sous forme binaire.
  • Image : lorsque le résultat est attendu sous forme d’image.
  • Objet C_OBJET : lorsque le résultat est attendu sous forme d'objet.

Note : Lorsqu'une variable texte est passée dans réponse, 4D tente de décoder les données retournées par le serveur. Le programme essaie d'abord de récupérer le charset depuis l'en-tête content-type, ou à défaut via la BOM de la page ; en dernier lieu 4D recherche tout attribut http-equiv charset (dans le contenu html) ou encoding (pour le xml). Si aucun charset ne peut être détecté, 4D décode la réponse en ANSI. Si la conversion échoue, le texte résultant est vide. Si vous n'êtes pas sûr que le serveur retourne une information de charset ou une BOM, mais si vous connaissez l'encodage, il est préférable de passer un BLOB dans réponse et d'utiliser la commande Convertir vers texte.

Si vous passez une variable de type C_OBJET dans le paramètre réponse et si la requête retourne un résultat ayant le content-type "application/json" (ou "quelquechose/json"), 4D tentera d’analyser le contenu JSON afin de générer l’objet.

Si le résultat retourné par le serveur ne correspond pas au type de la variable réponse, elle est laissée vide et la variable système OK prend la valeur 0. 

Vous pouvez passer dans les paramètres nomsEnTêtes et valeursEnTêtes des tableaux contenant respectivement les noms et les valeurs des en-têtes de la requête.
A l’issue de l’exécution de la méthode, ces tableaux contiendront les noms et valeurs des en-têtes retournés par le serveur HTTP. Ce principe permet notamment de gérer des cookies. 

Le paramètre * permet d’activer le mécanisme de keep-alive pour la connexion au serveur. Par défaut, si ce paramètre est omis, le keep-alive n’est pas activé. 

La commande retourne le code de statut HTTP standard (200=OK...) tel que renvoyé par le serveur. La liste des codes de statut HTTP est fournie dans la RFC 2616.
Si la connexion au serveur est impossible pour une raison liée au réseau (DNS Failed, Server not reachable...) la commande retourne 0 et une erreur est générée. Vous pouvez intercepter les erreurs à l’aide d’une méthode installée par la commande APPELER SUR ERREUR.

Demande de suppression d’un enregistrement dans une base distante :

 C_TEXTE($response)
 $body_t:="{record_id:25}"
 $httpStatus_l:=HTTP Request(HTTP méthode DELETE;"database.example.com";$body_t;$response)

Note : Il vous appartient de traiter la demande de manière appropriée au niveau du serveur distant, la commande HTTP Request gère uniquement la requête et le résultat retourné.

Demande d'ajout d’un enregistrement dans une base distante :

 C_TEXTE($response)
 $body_t:="{fName:'john',fName:'Doe'}"
 $httpStatus_l:=HTTP Request(HTTP méthode PUT;"database.example.com";$body_t;$response)

Note : Il vous appartient de traiter la demande de manière appropriée au niveau du serveur distant, la commande HTTP Request gère uniquement la requête et le résultat retourné.

Demande d’ajout d’enregistrement en JSON dans une base distante :

 C_OBJET($content)
 OB FIXER($content;"nom";"Doe";"prénom";"John")
 $result:=HTTP Request(HTTP méthode PUT;"database.example.com";$content;$response)



Voir aussi  

HTTP Get

 
PROPRIÉTÉS 

Produit : 4D
Thème : Client HTTP
Numéro : 1158
Nom intl. : HTTP Request

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D v13
Modifié : 4D v14

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)