本文详解如何使用 PHP 的 json_decode() 解析 eBay Commerce Taxonomy API 返回的 JSON 响应，并安全、准确地访问嵌套对象中的 categoryId、categoryName 等关键字段，附带错误处理与结构遍历技巧。
本文详解如何使用 php 的 `
js
on_decode()` 解析
ebay
commerce taxonomy api 返回的
json
响应，并安全、准确地访问嵌套对象中的 `categoryid`、`categoryname` 等关键字段，附带错误处理与结构遍历技巧。
在调用 eBay 的推荐类目 API（如 get_category_suggestions）时，响应默认为 JSON 格式。PHP 需通过 json_decode() 将其转换为可操作的对象（默认为 stdClass）或关联数组。初学者常因未理解嵌套层级或忽略空响应而报错（如 Trying to get property 'category' of non-object）。以下为完整、健壮的实践方案。
✅ 正确解析与取值（面向对象方式）
假设你已成功获取 API 响应字符串 $response（含有效 JSON），首先需确保解码成功：
eBay 的响应结构为：
要获取
首个推荐类目的 ID 和名称
，直接访问嵌套属性即可：
? 使用空合并运算符 ?? 可避免因某层属性缺失导致的 Notice 错误，提升鲁棒性。
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
? 遍历全部推荐类目（按需扩展）
若需提取全部结果，推荐使用 foreach 并做类型/存在性检查：
?️ 封装为可复用函数（支持动态字段）
参考提问者优化后的函数，我们进一步增强健壮性与灵活性：
⚠️ 关键注意事项
认证头必须正确
：Authorization: Bearer （非 TOKENGOESHERE 字面量），且 Token 需有 https://api.ebay.com/oauth/api_scope.commerce.taxonomy.readonly 权限。
URL 编码查询参数
：始终对 $query 使用 urlencode()，避免特殊字符破坏请求。
启用错误报告
：开发阶段建议开启 error_reporting(E_ALL); ini_set('display_errors', '1'); 快速定位问题。
不要忽略 HTTP 状态码
：curl_getinfo($ch, CURLINFO_HTTP_CODE) 必须为 200 才解析响应；4xx/5xx 需单独处理。
json_decode() 默认返回对象
：若偏好数组，传入第二个参数 true（即 json_decode($response, true)），此时用 ['categorySuggestions'][0]['category']['categoryId'] 访问。
掌握这一模式后，无论是 categoryTreeNodeAncestors 中的父类目链，还是其他 eBay API（如 findItemsByKeywords）的 JSON 响应，均可依此结构化思路高效提取所需数据。
$decodedData = json_decode($response);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new RuntimeException('Invalid JSON response: ' . json_last_error_msg());
}{
"categorySuggestions": [
{
"category": { "categoryId": 85892, "categoryName": "Doors" },
"categoryTreeNodeLevel": 4,
"categoryTreeNodeAncestors": [ ... ]
},
...
],
"categoryTreeId": 3,
"categoryTreeVersion": 118
}if (!empty($decodedData->categorySuggestions)) {
$first = $decodedData->categorySuggestions[0];
$categoryId = $first->category->categoryId ?? null;
$categoryName = $first->category->categoryName ?? null;
echo "Category ID: {$categoryId}\n";
echo "Category Name: {$categoryName}\n";
}foreach ($decodedData->categorySuggestions as $item) {
// 安全访问：确保 category 对象存在且含目标属性
if (isset($item->category) && is_object($item->category)) {
$id = $item->category->categoryId ?? 'N/A';
$name = $item->category->categoryName ?? 'N/A';
echo "ID: {$id} → Name: {$name}\n";
}
}function getEbayCategoryField(string $query, string $field = 'categoryId', int $limit = 1): array {
$url = 'https://api.ebay.com/commerce/taxonomy/v1/category_tree/3/get_category_suggestions?q=' . urlencode($query);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_ACCESS_TOKEN',
'Accept: application/json',
'Content-Type: application/json'
],
CURLOPT_TIMEOUT => 10,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode !== 200 || $response === false) {
throw new RuntimeException("API request failed (HTTP {$httpCode})");
}
$data = json_decode($response);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new RuntimeException('Invalid JSON in API response');
}
$results = [];
$count = 0;
foreach ($data->categorySuggestions as $suggestion) {
if ($count >= $limit) break;
if (isset($suggestion->category->$field)) {
$results[] = $suggestion->category->$field;
$count++;
}
}
return $results;
}
// 使用示例：
try {
$ids = getEbayCategoryField('Doors', 'categoryId', 3); // 获取前3个 categoryId
$names = getEbayCategoryField('Doors', 'categoryName', 2); // 获取前2个 categoryName
print_r($ids); // e.g., [85892, 36022, 37910]
print_r($names); // e.g., ['Doors', 'Door Stops']
} catch (Exception $e) {
error_log('Error: ' . $e->getMessage());
}