Ten dokument jest podzbiorem dokumentu Software Licensing API, który zawiera listę wszystkich funkcji dostępnych za pośrednictwem API. Poniższe informacje opisują, jak zaimplementować te funkcje za pomocą cURL.
cURL to narzędzie wiersza poleceń i biblioteka typu open source do przesyłania danych ze składnią URL. cURL jest preinstalowany w nowoczesnych wersjach Mac OS X oraz domyślnie w większości dystrybucji Linuksa. Możesz przetestować, wpisując
curl
w wierszu poleceń i naciskając Enter. Jeśli cURL jest zainstalowany, zobaczysz komunikat podobny do tego:
curl: try 'curl --help' or 'curl --manual' for more information
Aby poprosić cURL o wykonanie żądania HTTP, podaj mu swoje zmienne i adres URL, na który chcesz je wysłać, w następujący sposób:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
W powyższym przykładzie dodaliśmy prefiks -d do każdej zmiennej, aby zawartość została zakodowana w adresie URL. Odpowiedź na powyższe zapytanie będzie ciągiem znaków w formacie JSON, który będzie wyglądał mniej więcej tak:
{
"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]"
}
Flagi
cURL akceptuje wiele flag, aby zmienić jego zachowanie. Pełny samouczek cURL wykracza poza zakres tego dokumentu, ale spójrz na te flagi, które mogą Cię zainteresować:
- -u, –user USER[:PASSWORD] Użytkownik i hasło serwera
- -A, –user-agent STRING Wyślij STRING User-Agent do serwera (H)
- -d, –data DATA Dane POST HTTP (H)
- -s, –silent Tryb cichy (nie wyświetlaj niczego)
- -o, –output FILE Zapisz do FILE zamiast stdout
- -k, –insecure Zezwalaj na połączenia z witrynami SSL bez certyfikatów (H)
- -K, –config FILE Odczytaj konfigurację z FILE
skrypty bash
bash to powłoka uniksowa, która umożliwia skryptowanie akcji. Poniżej znajduje się prosty skrypt bash, który poprosi o kilka rzeczy, a następnie wykona żądanie cURL i wyświetli wynik na ekranie.
#!/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/;
Powyższy przykład można zmodyfikować, aby zadawać więcej pytań, używać różnych flag cURL lub czegokolwiek innego, co chcesz.
