このドキュメントは、APIで利用可能なすべての機能のリストであるソフトウェアライセンスAPIドキュメントのサブセットです。以下の情報は、cURLでこれらの機能を実装する方法です。
cURLは、URL構文を使用してデータを転送するためのオープンソースのコマンドラインツールおよびライブラリです。cURLは、最新バージョンのMac OS Xにインストールされており、ほとんどのLinuxディストリビューションではデフォルトで利用できます。単純に次のように入力してテストできます。
curl
コマンドラインでEnterキーを押します。cURLがインストールされていれば、次のようなメッセージが表示されます。
curl: try 'curl --help' or 'curl --manual' for more information
cURLにHTTPリクエストを実行させるには、次のように変数と送信先のURLを指定します。
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
上記の例では、各変数に-dを付けてプレフィックスを付けたため、内容はURLエンコードされます。上記のクエリへの応答は、次のようなJSON形式の文字列になります。
{
"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]"
}
フラグ
cURLは、その動作を変更するために多くのフラグを受け入れます。cURLの完全なチュートリアルはこのドキュメントの範囲外ですが、興味のある可能性のあるこれらのフラグをご覧ください。
- -u, –user USER[:PASSWORD] サーバーのユーザーとパスワード
- -A, –user-agent STRING サーバーにUser-Agent STRINGを送信します (H)
- -d, –data DATA HTTP POSTデータ (H)
- -s, –silent サイレントモード（何も出力しない）
- -o, –output FILE stdoutの代わりにFILEに書き込みます
- -k, –insecure 証明書なしでSSLサイトへの接続を許可します (H)
- -K, –config FILE FILEから設定を読み取ります
bashスクリプティング
bashは一般的なUnixシェルであり、アクションのスクリプティングを可能にします。以下は、いくつかの項目をプロンプトし、cURLリクエストを実行して出力を画面にレンダリングする簡単なbashスクリプトです。
#!/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/;
上記の例は、より多くの質問を尋ねたり、異なるcURLフラグを使用したり、好きなように変更したりできます。
