func X3.FR_HTTP_REQUETE(Clbfile URL_IN, Char METHODE_IN, Clbfile FICHIER_IN, Clbfile GET_CLES_IN, Clbfile GET_VALS_IN, Clbfile POST_CLES_IN, Clbfile POST_VALS_IN, Clbfile ENTETES_CLES_OUT, Clbfile ENTETES_VALS_OUT, Clbfile COOKIES_CLES_OUT, Clbfile COOKIES_VALS_OUT, Clbfile CORPS_OUT) : Integer

Permet de lancer une requête HTTP pour ouvrir une page ou faire un appel API REST ou SOAP

  • URL_IN Clbfile Url de la ressource à interroger SANS paramètres GET ni "?" (Ex : https://www.google.com/search)
  • METHODE_IN Char Méthode à utiliser (POST, GET, PUT, DELETE, HEAD, CONNECT, OPTIONS, TRACE, PATCH)
  • FICHIER_IN Clbfile Chemin complet ou volume vers le fichier à envoyer
  • GET_CLES_IN Clbfile Tableau des clés des paramètres GET à envoyer
  • GET_VALS_IN Clbfile Tableau des valeurs des paramètres GET à envoyer
  • POST_CLES_IN Clbfile Tableau des clés des paramètres POST à envoyer
  • POST_VALS_IN Clbfile Tableau des valeurs des paramètres POST à envoyer
  • ENTETES_CLES_OUT Clbfile Tableau des clés des paramètres HEADER à envoyer et reçues une fois la requête executée
  • ENTETES_VALS_OUT Clbfile Tableau des valeurs des paramètres HEADER à envoyer et reçues une fois la requête executée
  • COOKIES_CLES_OUT Clbfile Tableau des clés des paramètres COOKIES à envoyer et reçus une fois la requête executée
  • COOKIES_VALS_OUT Clbfile Tableau des valeurs des paramètres COOKIES à envoyer et reçus une fois la requête executée
  • CORPS_OUT Clbfile Corps à envoyer et corps reçu une fois la requête executée
Retour Integer Code retour HTTP du serveur ou 0 si erreur (200, 404, 503, ...)
Exemples

# Récupération d'un token de connexion Microsoft ou affichage des cookies, entêtes et corps en cas d'erreur

Local Clbfile URL_IN(0)
Local Char METHODE_IN(7)
Local Clbfile FICHIER_IN(0)
Local Clbfile GET_CLES_IN(0)(20), GET_VALS_IN(0)(20)
Local Clbfile POST_CLES_IN(0)(20), POST_VALS_IN(0)(20)
Local Clbfile ENTETES_CLES_OUT(0)(20), ENTETES_VALS_OUT(0)(20)
Local Clbfile COOKIES_CLES_OUT(0)(20), COOKIES_VALS_OUT(0)(20)
Local Clbfile CORPS_OUT(0)
Local Integer CODE_HTTP, Y

[L]URL_IN = "https://login.microsoftonline.com/XXXX-XXXX-XXXX-XXXX-XXXX/oauth2/v2.0/token"
[L]METHODE_IN = "POST"
[L]POST_CLES_IN(0) = "grant_type" : [L]POST_VALS_IN(0) = "client_credentials"
[L]POST_CLES_IN(1) = "client_id" : [L]POST_VALS_IN(1) = "XXXX-XXXX-XXXX-XXXX-XXXX"
[L]POST_CLES_IN(2) = "client_secret" : [L]POST_VALS_IN(2) = "XXXX~XXXX~XXXX"
[L]POST_CLES_IN(3) = "scope" : [L]POST_VALS_IN(3) = "https://graph.microsoft.com/.default"

# Lancement de la requête
[L]CODE_HTTP = func X3.FR_HTTP_REQUETE(URL_IN, METHODE_IN,
& FICHIER_IN,
& GET_CLES_IN, GET_VALS_IN,
& POST_CLES_IN, POST_VALS_IN,
& ENTETES_CLES_OUT, ENTETES_VALS_OUT,
& COOKIES_CLES_OUT, COOKIES_VALS_OUT,
& CORPS_OUT)

# Si pas OK (CODE <> 20X) on veut le détail
If [L]CODE_HTTP < 200 | [L]CODE_HTTP >= 300
For Y=0 To dim(ENTETES_CLES_OUT)-1
If ENTETES_CLES_OUT(Y) <> ""
Infbox "Header : " + ENTETES_CLES_OUT(Y) + ": " + ENTETES_VALS_OUT(Y)
Else
Break 1
Endif
Next
For Y=0 To dim(COOKIES_CLES_OUT)-1
If COOKIES_CLES_OUT(Y) <> ""
Infbox "Cookie : " + COOKIES_CLES_OUT(Y) + ": " + COOKIES_VALS_OUT(Y)
Else
Break 1
Endif
Next
Call AFFMES("Body : " + CORPS_OUT) From GESECRAN
Else
# Récupération du token dans le Json
Call AFFMES(func X3.FR_JSON_RECUP_VALEUR(CORPS_OUT, "access_token")) From GESECRAN
Endif