
在进行跨语言的api调用代码转换时,一个常见的挑战是理解不同语言或库处理http请求体的方式差异。尤其是在处理包含json数据的post请求时,python的requests库和php的http客户端库(如requests或curl)之间存在微妙但关键的区别。本文将以fedex追踪api为例,详细阐述这种差异及其解决方案。
原始的Python脚本使用requests.post()方法向FedEx追踪API发送请求。关键在于其data参数的构造方式:
data = requests.post('https://www.fedex.com/trackingCal/track', data={
'data': json.dumps({ # 注意这里,'data'的值被json.dumps处理
'TrackPackagesRequest': {
# ...
}
}),
'action': 'trackpackages',
'locale': 'en_US',
'format': 'json',
'version': 99
}).json()在Python的requests库中:
因此,Python脚本实际上发送的是一个表单编码的请求体,其中一个名为data的字段,其值是一个JSON字符串。
在PHP中,常见的HTTP客户端库(如Requests库)在处理POST请求时,如果直接将整个数据数组传递给请求体参数,并期望它能自动识别内部的JSON结构,可能会遇到问题。
立即学习“PHP免费学习笔记(深入)”;
以下是最初的PHP尝试:
<?php
// ...
$headers = ['Content-Type' => 'application/json']; // 错误点之一
$data = ['data' => [ // 这是一个PHP数组
'TrackPackagesRequest' => [
// ...
]],
'action' => 'trackpackages',
'locale' => 'en_US',
'format' => 'json',
'version' => 99
];
$response = Requests::post($url, $headers, json_encode($data)); // 错误点之二
// ...
?>这个PHP尝试存在两个主要问题:
结合这两点,PHP脚本发送了一个Content-Type: application/json的请求,并且请求体是一个完整的JSON对象。然而,FedEx API期望的是一个application/x-www-form-urlencoded的请求,其中一个字段的值是JSON字符串。这种不匹配导致API返回错误信息:"CALError": {"code":"UNSUPPORTED.ACTION", "message":" is not a supported action"},表明API无法解析或理解收到的请求格式。
要正确地将Python脚本的逻辑转换为PHP,我们需要模拟Python requests库发送表单编码请求的行为,并确保只有data参数的值被JSON编码。
核心思想是:
以下是修正后的PHP代码:
<?php
// 引入Composer自动加载文件
$dir = __DIR__;
include $dir .'/vendor/autoload.php';
// 示例追踪号
$tracking_number = '123456789';
// API请求URL
$url = 'https://www.fedex.com/trackingCal/track';
// 清空或不设置Content-Type头,让Requests库默认使用form-urlencoded
$headers = [];
// 构建请求数据
$data = [
// 关键:只有'data'字段的值被json_encode
"data" => json_encode([
"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函数在接收数组作为第三个参数时,默认会将其进行form-urlencoded编码
$response = Requests::post($url, $headers, $data);
// 打印响应结果
print_r($response);
// 解析并使用响应数据(如果成功)
if ($response->success) {
$responseData = json_decode($response->body, true);
if (isset($responseData['TrackPackagesResponse']['packageList'][0])) {
$packageInfo = $responseData['TrackPackagesResponse']['packageList'][0];
$fedex_status = $packageInfo['keyStatus'];
$fedex_details = $packageInfo['statusWithDetails'];
$delivery_date = $packageInfo['displayActDeliveryDt'];
$delivery_time = $packageInfo['displayActDeliveryTm'];
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 "Package information not found in response.\n";
}
} else {
echo "Request failed: " . $response->status_code . " - " . $response->body . "\n";
}
?>从Python脚本到PHP的API调用转换,不仅仅是语法层面的翻译,更是对底层HTTP协议和特定库行为的理解。本文通过FedEx追踪API的案例,深入剖析了application/x-www-form-urlencoded和application/json这两种常见请求体格式的差异,以及如何在PHP中正确模拟Python requests库的特定行为。掌握这些知识,将有助于开发者更高效、准确地完成跨语言的API集成工作。
以上就是Python转PHP:FedEx追踪API请求体转换深度解析的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号