Acest document este un subset al documentului API de Licențiere Software care listează toate funcționalitățile disponibile prin API. Următoarele informații explică cum să implementați acele funcționalități cu cURL.
cURL este un instrument open source de linie de comandă și o bibliotecă pentru transferul datelor cu sintaxă URL. cURL vine instalat pe versiunile moderne de Mac OS X și implicit în majoritatea distribuțiilor Linux. Puteți testa pur și simplu tastând
curl
pe linia de comandă și apăsând enter. Dacă cURL este instalat, veți vedea un mesaj similar cu acesta:
curl: try 'curl --help' or 'curl --manual' for more information
Pentru a cere cURL să facă o cerere HTTP pentru dvs., spuneți-i variabilele dvs. și URL-ul către care doriți să o trimiteți, astfel:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
În exemplul de mai sus, am prefixat fiecare variabilă cu -d, astfel încât conținutul să fie urlencoded. Un răspuns la interogarea de mai sus ar fi un șir formatat JSON care ar arăta cam așa:
{
"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]"
}
Steaguri
cURL acceptă multe steaguri pentru a-i schimba comportamentul. Un tutorial complet despre cURL depășește scopul acestui document, dar aruncați o privire la aceste steaguri care v-ar putea interesa:
- -u, –user UTILIZATOR[:PAROLĂ] Utilizator și parolă server
- -A, –user-agent STRING Trimite STRING User-Agent către server (H)
- -d, –data DATA Date POST HTTP (H)
- -s, –silent Mod silențios (nu afișa nimic)
- -o, –output FIȘIER Scrie în FIȘIER în loc de stdout
- -k, –insecure Permite conexiuni la site-uri SSL fără certificate (H)
- -K, –config FIȘIER Citește configurația din FIȘIER
scriptare bash
bash este o consolă Unix comună și permite scriptarea acțiunilor. Următorul este un script bash simplu care va solicita mai multe informații, apoi va rula cererea cURL și va afișa rezultatul pe ecran.
#!/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/;
Exemplul de mai sus ar putea fi modificat pentru a pune mai multe întrebări, a avea diferite steaguri cURL sau orice doriți.
