
在进行api调用时,理解http请求体的构造方式至关重要。python的 requests 库提供了两种主要的方式来发送post请求的数据:data 参数和 json 参数。
在FedEx包裹追踪的Python示例中,我们可以看到如下代码片段:
data = requests.post('https://www.fedex.com/trackingCal/track', data={
'data': json.dumps({
'TrackPackagesRequest': {
# ... 省略内部结构 ...
}
}),
'action': 'trackpackages',
'locale': 'en_US',
'format': 'json',
'version': 99
}).json()这里,requests.post 使用了 data 参数,并且其值是一个字典。注意,字典中的 data 键对应的值是通过 json.dumps() 序列化后的JSON字符串。这意味着整个请求体实际上是URL编码的表单数据,其中一个字段 data 的值恰好是JSON格式的字符串。服务器期望接收的是一个表单,而不是一个纯粹的JSON请求体。
将上述Python逻辑转换为PHP时,常见的错误是直接将整个请求数据结构 json_encode 后作为请求体发送,并设置 Content-Type 为 application/json。
错误的PHP尝试可能如下所示:
立即学习“PHP免费学习笔记(深入)”;
<?php
// ... 省略初始化代码 ...
$headers = ['Content-Type' => 'application/json']; // 错误:不应是application/json
$data = ['data' => [ // 这是一个PHP数组
'TrackPackagesRequest' => [
// ... 省略内部结构 ...
]],
'action' => 'trackpackages',
'locale' => 'en_US',
'format' => 'json',
'version' => 99
];
$response = Requests::post($url, $headers, json_encode($data)); // 错误:对整个$data数组进行json_encode
print_r($response);这段代码会返回 { "CALError": { "code":"UNSUPPORTED.ACTION", "message":" is not a supported action", "rootCause":null } } 错误。
原因分析:
这与Python脚本中实际发送的请求格式(URL编码的表单数据,其中一个字段的值是JSON字符串)不符。FedEx服务器期望的是一个包含 data、action、locale 等字段的表单,而不是一个直接以 TrackPackagesRequest 开头的JSON对象。
要正确地将Python脚本中的逻辑转换为PHP,我们需要模拟Python requests.post(data=...) 的行为:发送URL编码的表单数据,并且只对 data 字段的值进行JSON编码。
以下是修正后的PHP代码示例:
<?php
// 假设您已经通过Composer安装了Requests库,并设置了自动加载
$dir = __DIR__;
include $dir .'/vendor/autoload.php'; // 引入Requests库
// 追踪号码示例
$tracking_number = '123456789';
// FedEx追踪API的URL
$url = 'https://www.fedex.com/trackingCal/track';
// HTTP请求头,这里不需要明确设置Content-Type为application/json
// Requests库在发送表单数据时会自动处理为 application/x-www-form-urlencoded
$headers = [];
// 构建请求数据数组
// 关键点:只有 'data' 字段的值需要被 json_encode
$data = [
"data" => json_encode([ // 将TrackPackagesRequest部分编码为JSON字符串
"TrackPackagesRequest" => [
"appType" => "wtrk",
"uniqueKey" => "",
"processingParameters" => [
"anonymousTransaction" => true,
"clientId" => "WTRK",
"returnDetailedErrors" => true,
"returnLocalizedDateTime" => false
],
"trackingInfoList" => [[
"trackNumberInfo" => [
"trackingNumber" => $tracking_number,
"trackingQualifier" => "",
"trackingCarrier" => ""
]
]]
]
]),
"action" => "trackpackages",
"locale" => "en_US",
"format" => "json",
"version" => 99
];
// 发送POST请求
// Requests::post() 方法如果接收一个数组作为第三个参数($data),
// 默认会将其作为 application/x-www-form-urlencoded 类型的表单数据发送
$response = Requests::post($url, $headers, $data);
// 打印API响应
print_r($response);
// 进一步处理响应(例如解析JSON)
if ($response->success) {
$responseData = json_decode($response->body, true);
// 提取所需信息
$fedex_status = $responseData['TrackPackagesResponse']['packageList'][0]['keyStatus'] ?? 'N/A';
$fedex_details = $responseData['TrackPackagesResponse']['packageList'][0]['statusWithDetails'] ?? 'N/A';
$delivery_date = $responseData['TrackPackagesResponse']['packageList'][0]['displayActDeliveryDt'] ?? 'N/A';
$delivery_time = $responseData['TrackPackagesResponse']['packageList'][0]['displayActDeliveryTm'] ?? 'N/A';
echo "FedEx Status: " . $fedex_status . "\n";
echo "Details: " . $fedex_details . "\n";
echo "Delivery Date: " . $delivery_date . "\n";
echo "Delivery Time: " . $delivery_time . "\n";
} else {
echo "Error: " . $response->status_code . " - " . $response->body . "\n";
}
?>核心改进点:
将Python脚本中涉及复杂数据结构的POST请求转换为PHP时,关键在于精确复刻原始请求的HTTP协议细节。对于像FedEx追踪API这样期望URL编码表单数据,且其中某个字段值本身又是JSON字符串的场景,务必确保 json_encode 的作用范围仅限于该特定字段,而不是整个请求体。通过遵循这些原则,可以有效避免常见的API集成错误,确保跨语言代码转换的成功。
以上就是Python到PHP:FedEx追踪API的POST请求数据转换指南的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号