Dieses Dokument ist ein Teilsatz des Software Licensing API-Dokuments, das alle über die API verfügbaren Funktionen auflistet. Die folgenden Informationen beschreiben, wie diese Funktionen mit cURL implementiert werden.
cURL ist ein Open-Source-Befehlszeilentool und eine Bibliothek zur Datenübertragung mit URL-Syntax. cURL ist auf modernen Versionen von Mac OS X und standardmäßig in den meisten Linux-Distributionen vorinstalliert. Sie können es einfach testen, indem Sie Folgendes eingeben
curl
in der Befehlszeile und die Eingabetaste drücken. Wenn cURL installiert ist, sehen Sie eine Meldung, die dieser ähnelt:
curl: try 'curl --help' or 'curl --manual' for more information
Um cURL zu bitten, eine HTTP-Anfrage für Sie zu stellen, teilen Sie ihm Ihre Variablen und die URL mit, an die Sie sie senden möchten, wie folgt:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
Im obigen Beispiel haben wir jeder Variablen das Präfix -d vorangestellt, damit der Inhalt URL-codiert wird. Eine Antwort auf die obige Abfrage wäre ein JSON-formatierter String, der ungefähr so aussehen würde:
{
"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]"
}
Flags
cURL akzeptiert viele Flags, um sein Verhalten zu ändern. Ein vollständiges Tutorial zu cURL liegt außerhalb des Rahmens dieses Dokuments, aber werfen Sie einen Blick auf diese Flags, die Sie interessieren könnten:
- -u, –user BENUTZER[:PASSWORT] Server-Benutzer und -Passwort
- -A, –user-agent STRING Sendet STRING als User-Agent an den Server (H)
- -d, –data DATEN HTTP POST-Daten (H)
- -s, –silent Silent-Modus (gib nichts aus)
- -o, –output DATEI Schreibe in DATEI statt in stdout
- -k, –insecure Erlaube Verbindungen zu SSL-Sites ohne Zertifikate (H)
- -K, –config DATEI Lese Konfiguration aus DATEI
Bash-Skripting
Bash ist eine gängige Unix-Shell und ermöglicht das Skripten von Aktionen. Das Folgende ist ein einfaches Bash-Skript, das nach mehreren Dingen fragt, dann die cURL-Anfrage ausführt und die Ausgabe auf dem Bildschirm anzeigt.
#!/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/;
Das obige Beispiel könnte geändert werden, um mehr Fragen zu stellen, andere cURL-Flags zu verwenden oder was auch immer Sie wünschen.
