Ce document est un sous-ensemble du document de l’API de licences de logiciels qui répertorie toutes les fonctionnalités disponibles via l’API. Les informations suivantes expliquent comment implémenter ces fonctionnalités avec cURL.
cURL est un outil et une bibliothèque open source en ligne de commande pour transférer des données avec une syntaxe d’URL. cURL est préinstallé sur les versions modernes de Mac OS X, et par défaut dans la plupart des distributions Linux. Vous pouvez tester simplement en tapant
curl
dans la ligne de commande et en appuyant sur Entrée. Si cURL est installé, vous verrez un message similaire à celui-ci :
curl: try 'curl --help' or 'curl --manual' for more information
Pour demander à cURL d’effectuer une requête HTTP pour vous, indiquez-lui vos variables et l’URL à laquelle vous souhaitez l’envoyer, comme ceci :
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
Dans l’exemple ci-dessus, nous avons préfixé chaque variable avec -d afin que le contenu soit encodé en URL. Une réponse à la requête ci-dessus serait une chaîne formatée en JSON qui ressemblerait à ceci :
{
"license": "valid",
"item_name": "EDD Product name",
"expires": "2014-10-23 00:00:00",
"payment_id": 54224,
"customer_name": "John Doe",
"customer_email": "[email protected]"
}
Indicateurs
cURL accepte de nombreux indicateurs pour modifier son comportement. Un tutoriel complet sur cURL sort du cadre de ce document, mais jetez un œil à ces indicateurs qui pourraient vous intéresser :
- -u, –user UTILISATEUR[:MOT DE PASSE] Utilisateur et mot de passe du serveur
- -A, –user-agent CHAÎNE Envoyer la CHAÎNE User-Agent au serveur (H)
- -d, –data DONNÉES Données POST HTTP (H)
- -s, –silent Mode silencieux (ne rien afficher)
- -o, –output FICHIER Écrire dans FICHIER au lieu de stdout
- -k, –insecure Autoriser les connexions aux sites SSL sans certificats (H)
- -K, –config FICHIER Lire la configuration depuis FICHIER
scripting bash
bash est un shell Unix courant et permet de scripter des actions. Voici un script bash simple qui demandera plusieurs informations, puis exécutera la requête cURL et affichera le résultat à l’écran.
#!/bin/bash
# This script accepts arguments for accessing the Easy Digital Downloads
# Software Licensing REST API, then runs cURL to get the results.
read -p "Item ID: " item_id;
read -p "EDD Action: " edd_action;
read -p "License: " license;
read -p "URL: " url;
exec curl --data-urlencode "item_id=$item_id" --data-urlencode "edd_action=$edd_action" --data-urlencode "license=$license" --data-urlencode "url=$url" https://YOURSITE.com/;
L’exemple ci-dessus pourrait être modifié pour poser plus de questions, utiliser différents indicateurs cURL, ou tout ce que vous souhaitez.
