必読: Taobao 注文クエリ API ドキュメント分析、PHP 開発者に適しています-PHPチュートリアル-php.cn

必読: Taobao 注文クエリ API ドキュメント分析、PHP 開発者に適しています

WBOY

リリース： 2023-06-30 14:22:01

オリジナル

1323 人が閲覧しました

PHP 開発者は必読!淘宝網注文クエリ API ドキュメント分析

電子商取引の急速な発展に伴い、ますます多くの開発者が電子商取引分野に流入しています。電子商取引プラットフォームの最も重要なプレーヤーの 1 つとして、タオバオは豊富な API インターフェイスを提供し、開発者に便利で高速な開発ツールを提供します。その中でも、淘宝注文クエリ API はよく使用される機能であり、この記事では、PHP 開発者がこの API をよりよく理解して使用できるように、この API のドキュメントを分析します。

API キーの取得
淘宝網注文クエリ API を使用する前に、開発者はまず API キーを取得する必要があります。タオバオオープンプラットフォームの開発者センターでは、独自のAPIキーを申請できます。 API キーを取得した後、開発者はセキュリティを確保し、正しく使用するためにそれを保管する必要があります。
リクエスト URL とパラメータ
淘宝網注文クエリ API のリクエスト URL は次のとおりです:
https://gw.api.taabao.com/router/rest

ここで、次の必須パラメータがあります:

method: 呼び出す API メソッドを指定します (例: taabao.trade.get
app_key: 開発者のアプリケーションキー
session: ユーザー ID の検証に使用される承認済みトークン
timestamp: yyyy-MM-dd HH:mm:ss 形式の通話タイムスタンプ (タイムゾーンは GMT 8)
v: API プロトコルのバージョン番号、現在 2.0
sign: パラメータの署名検証に使用される署名文字列

必須パラメータに加えて、必要なパラメータに応じてパラメータを追加することもできます。他のオプションのパラメータが必要です。fields (返されるフィールド)、tid (トランザクション注文番号) などです。特定のパラメータは API ドキュメントで確認できます。

署名文字列を構築する
淘宝網注文クエリ API をリクエストする前に、すべてのパラメータに署名する必要があります。このうち署名アルゴリズムはHMAC-SHA1を使用します。署名文字列の構築は、特定のルールに従う必要があります。
すべてのリクエストパラメータをパラメータ名の辞書順に並べ替えます
パラメータ名とパラメータ値を「=」で接続し、「」を形成します「パラメータ」を「名前=パラメータ値」の形式にします。
各「パラメータ名=パラメータ値」文字列を「&」で接続します。
署名文字列の最後に app_secret を接続します。
結合された文字列の HMAC-SHA1 署名

署名文字列を構築するコード例:

function buildRequestSign($params, $appSecret) {
    ksort($params);
    $signString = '';
    foreach ($params as $key => $value) {
        $signString .= $key . "=" . $value . "&";
    }
    $signString .= "app_secret=" . $appSecret;
    return strtoupper(hash_hmac("sha1", $signString, $appSecret));
}

ログイン後にコピー

リクエストを送信し、結果を解析します
署名を作成する文字列の後に署名値をリクエストパラメータに入力し、HTTP リクエストを Taobao 注文クエリ API に送信します。 API ドキュメントの要件に従って、リクエストメソッドは GET または POST にすることができますが、ここでは GET メソッドを例に挙げます。

curl を使用して GET リクエストを送信するコード例:

$url = "https://gw.api.taobao.com/router/rest";
$response = file_get_contents($url . '?' . http_build_query($params));
$result = json_decode($response, true);

ログイン後にコピー

返された結果を解析するコード例:

if ($result['error_response']) {
    echo "API调用失败：" . $result['error_response']['msg'];
} else {
    echo "API调用成功：";
    // 处理返回结果
}

ログイン後にコピー

返された結果を解析することで、開発者は次のことを取得できます。注文注文番号、購入者の名前、製品名、支払い金額などの関連情報。

概要:
この記事では、PHP 開発者がこの重要な API インターフェイスをよりよく理解し、使用できるように、Taobao 注文クエリ API のドキュメントを分析および説明します。パラメータ、署名文字列を正確に構築し、HTTP リクエストを送信することで、開発者は注文関連の情報を迅速に取得でき、電子商取引プラットフォームアプリケーション開発に便利なツールを提供します。この記事が、淘宝網注文クエリ API を使用する際の PHP 開発者にヘルプとガイダンスを提供できれば幸いです。

以上が必読: Taobao 注文クエリ API ドキュメント分析、PHP 開発者に適していますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。