如何使用 cURL 正确调用返回 XML 的 Rakuten API-php教程-PHP中文网

如何使用 cURL 正确调用返回 XML 的 Rakuten API

本文详解为何直接在浏览器访问 rakuten 库存 api 成功而 curl 失败，并提供符合其认证机制的正确 php 实现——关键在于将必要参数作为查询字符串拼入 url，而非置于 http 请求头中。

本文详解为何直接在浏览器访问 rakuten 库存 api 成功而 curl 失败，并提供符合其认证机制的正确 php 实现——关键在于将必要参数作为查询字符串拼入 url，而非置于 http 请求头中。

Rakuten 法国购物平台的库存 Web Service（https://ws.fr.shopping.rakuten.com/stock_ws）要求所有认证与操作参数（如 action、login、pwd、version）必须以 URL 查询参数（query string） 形式传递，而非通过自定义请求头发送。你原始代码中将 action: export、login: mylogin 等写入 CURLOPT_HTTPHEADER，会导致服务端无法识别这些凭据，从而返回模糊错误 01 - Unavailable service ——这并非服务不可用，而是参数未按预期方式送达。

✅ 正确做法是：先构建完整带参数的 URL，再发起 cURL 请求，并仅保留标准 Accept: application/xml 头用于内容协商。

以下是经过验证的完整 PHP 示例：

CurlShip Directory Submission

向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

<?php $url = "https://ws.fr.shopping.rakuten.com/stock_ws";

// 所有必需参数必须作为查询参数传递（不可放 header！）
$args = [
    'action' => 'export',
    'login'  => 'mylogin',      // 替换为你的实际登录名
    'pwd'    => 'mytokenxxx',   // 替换为你的实际 API token
    'version'=> '2018-06-29'
];

// 拼接为合法 URL（自动处理 URL 编码）
$url_with_params = $url . '?' . http_build_query($args);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url_with_params);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 30);

// 仅设置语义明确的标准 Accept 头
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Accept: application/xml'
]);

// ⚠️ 生产环境务必移除以下两行！仅测试时临时禁用 SSL 校验
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($curl);
$http_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false) {
    throw new RuntimeException('cURL error: ' . curl_error($curl));
}

// 建议：检查 HTTP 状态码 + 响应内容类型
if ($http_code !== 200) {
    echo "HTTP Error: {$http_code}\n";
}
if (strpos($response, '<?xml ') !== 0) {
    echo "Warning: Response may not be valid XML.\n";
}

var_dump($response);

? 关键注意事项：

❌ 不要将 action/login/pwd/version 放入 CURLOPT_HTTPHEADER —— 该 API 不支持 Header 认证；
✅ 必须使用 http_build_query() 安全拼接参数，避免手动拼接导致编码错误（如特殊字符未转义）；
? CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST 在生产环境中必须设为 true（默认值），禁用它们会带来严重安全风险；
? 若仍返回 Sender InvalidUserConnection 错误，请确认 login 和 pwd 值准确无误（区分大小写、无多余空格），并核实该账号是否已开通对应 API 权限；
? 部分 API 对 User-Agent 有要求，若持续失败，可补充：curl_setopt($curl, CURLOPT_USERAGENT, 'PHP-cURL/1.0');

遵循此模式后，cURL 将发出与浏览器完全一致的请求，成功获取结构化 XML 响应，为后续解析（如 simplexml_load_string()）奠定可靠基础。