PHP集成Walmart Returns API教程：认证与请求参数详解

<?php

/**
 * 生成一个符合UUID v4规范的GUID
 * @return string GUID字符串
 */
function generateUuidV4() {
    // 根据RFC 4122规范生成UUID v4
    // xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
    // '4' 表示版本号，'y' 表示变体 (8, 9, a, or b)
    return sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
        mt_rand(0, 0xffff), mt_rand(0, 0xffff), // 16位时间低
        mt_rand(0, 0xffff),                     // 16位时间中
        mt_rand(0, 0x0fff) | 0x4000,            // 16位时间高 + 版本号 (4)
        mt_rand(0, 0x3fff) | 0x8000,            // 16位时钟序列高 + 变体 (8, 9, a, b)
        mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff) // 48位节点
    );
}

// 示例：生成一个GUID
// $correlationId = generateUuidV4();
// echo $correlationId; // 输出类似 "f47ac10b-58cc-4372-a567-0e02b2c3d479" 的字符串

?>

<?php

// 假设您的客户端ID和密钥已定义
define('CLIENT_ID', 'YOUR_CLIENT_ID');
define('SECRET_KEY', 'YOUR_SECRET_KEY');

// GUID生成函数（如上所示）
function generateUuidV4() {
    return sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
        mt_rand(0, 0xffff), mt_rand(0, 0xffff),
        mt_rand(0, 0xffff),
        mt_rand(0, 0x0fff) | 0x4000,
        mt_rand(0, 0x3fff) | 0x8000,
        mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)
    );
}

$getTokenUrl = 'https://marketplace.walmartapis.com/v3/token';
$authorization_key = base64_encode(CLIENT_ID . ":" . SECRET_KEY);
$correlation_id_token = generateUuidV4(); // 使用GUID生成相关ID

$tokenHeaders = array(
    'Authorization: Basic ' . $authorization_key,
    'WM_SVC.NAME: Walmart Marketplace',
    'WM_QOS.CORRELATION_ID: ' . $correlation_id_token,
    'Content-Type: application/x-www-form-urlencoded'
);

$postFields = 'grant_type=client_credentials';

$ch = curl_init();
curl_setopt_array($ch, array(
    CURLOPT_URL => $getTokenUrl,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true, // 明确指定POST请求
    CURLOPT_POSTFIELDS => $postFields,
    CURLOPT_HTTPHEADER => $tokenHeaders,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30, // 设置超时时间
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
));

$tokenResponse = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
    exit();
}

$accessToken = null;
if ($httpCode == 200) {
    $tokenData = json_decode($tokenResponse, true);
    if (isset($tokenData['access_token'])) {
        $accessToken = $tokenData['access_token'];
        echo "Access Token: " . $accessToken . "\n";
    } else {
        echo "Failed to get access token. Response: " . $tokenResponse . "\n";
    }
} else {
    echo "HTTP Error " . $httpCode . ": " . $tokenResponse . "\n";
}

curl_close($ch);

// 如果成功获取到accessToken，可以在此继续调用Returns API
if ($accessToken) {
    // ... (继续第二步：调用Returns API)
}

?>

<?php

// ... (接续上一步获取accessToken的代码)

if ($accessToken) {
    $returnsApiUrl = 'https://marketplace.walmartapis.com/v3/returns';
    $correlation_id_returns = generateUuidV4(); // 为Returns API调用生成新的GUID

    $returnsHeaders = array(
        'WM_SEC.ACCESS_TOKEN: ' . $accessToken,
        'WM_QOS.CORRELATION_ID: ' . $correlation_id_returns,
        'WM_SVC.NAME: Walmart Marketplace',
        'Content-Type: application/xml', // 根据API文档或原问题，此处可能需要指定
        // 'Accept: application/xml' // 如果您期望XML响应，可以添加此头部
    );

    $ch_returns = curl_init(); // 为Returns API创建新的cURL句柄

    curl_setopt_array($ch_returns, array(
        CURLOPT_URL => $returnsApiUrl,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => 'GET', // 明确指定GET请求
        CURLOPT_HTTPHEADER => $returnsHeaders,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    ));

    $returnsResponse = curl_exec($ch_returns);
    $httpCodeReturns = curl_getinfo($ch_returns, CURLINFO_HTTP_CODE);

    if (curl_errno($ch_returns)) {
        echo 'cURL Error for Returns API: ' . curl_error($ch_returns);
    } else {
        echo "\nReturns API HTTP Code: " . $httpCodeReturns . "\n";
        echo "Returns API Response: " . $returnsResponse . "\n";
    }

    curl_close($ch_returns);
}

?>