Questo documento è un sottoinsieme del documento API licenze software che elenca tutte le funzionalità disponibili tramite l'API. Le seguenti informazioni spiegano come implementare tali funzionalità con cURL.
cURL è uno strumento da riga di comando e una libreria open source per trasferire dati con sintassi URL. cURL è preinstallato nelle versioni moderne di Mac OS X e per impostazione predefinita nella maggior parte delle distribuzioni Linux. Puoi testarlo semplicemente digitando
curl
sulla riga di comando e premendo invio. Se cURL è installato, vedrai un messaggio simile a questo:
curl: try 'curl --help' or 'curl --manual' for more information
Per chiedere a cURL di effettuare una richiesta HTTP per te, specificagli le tue variabili e l'URL a cui desideri inviarla, in questo modo:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
Nell'esempio precedente abbiamo anteposto -d a ogni variabile in modo che il contenuto venga codificato per URL. Una risposta alla query sopra sarebbe una stringa formattata in JSON che assomiglierebbe a questo:
{
"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]"
}
Flag
cURL accetta molti flag per modificarne il comportamento. Un tutorial completo su cURL è al di fuori dello scopo di questo documento, ma dai un'occhiata a questi flag che potrebbero interessarti:
- -u, –user UTENTE[:PASSWORD] Utente e password del server
- -A, –user-agent STRING Invia STRINGA User-Agent al server (H)
- -d, –data DATI Dati POST HTTP (H)
- -s, –silent Modalità silenziosa (non visualizzare nulla)
- -o, –output FILE Scrivi su FILE invece che su stdout
- -k, –insecure Consenti connessioni a siti SSL senza certificati (H)
- -K, –config FILE Leggi la configurazione da FILE
scripting bash
bash è una shell Unix comune e consente di eseguire azioni in script. Quello che segue è un semplice script bash che richiederà diverse informazioni, quindi eseguirà la richiesta cURL e visualizzerà l'output sullo schermo.
#!/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'esempio sopra potrebbe essere modificato per porre più domande, avere flag cURL diversi o qualsiasi altra cosa desideri.
