在電商領(lǐng)域,獲取商品詳情信息是數(shù)據(jù)分析、價(jià)格監(jiān)控、商品推薦等場景中的常見需求。通過調(diào)用商品詳情 API,可以高效地獲取商品的標(biāo)題、價(jià)格、圖片、描述等詳細(xì)信息。本文將詳細(xì)介紹如何使用 PHP 爬蟲技術(shù)調(diào)用商品詳情 API,并對返回值進(jìn)行詳細(xì)說明。
一、準(zhǔn)備工作
1. 注冊 API 賬號
要使用商品詳情 API,首先需要在相應(yīng)的開放平臺注冊賬號,并創(chuàng)建應(yīng)用以獲取 App Key 和 App Secret。這些是調(diào)用 API 所必需的憑證。
2. 安裝必要的 PHP 庫
確保你的 PHP 環(huán)境中已經(jīng)安裝了以下庫:
- GuzzleHttp\Client:用于發(fā)送 HTTP 請求。
- json:用于處理 JSON 數(shù)據(jù)。
- 如果尚未安裝這些庫,可以通過以下命令進(jìn)行安裝:
bash
composer require guzzlehttp/guzzle
二、代碼實(shí)現(xiàn)
以下是一個(gè)完整的 PHP 示例代碼,展示如何調(diào)用商品詳情 API,并處理返回的數(shù)據(jù)。
1. 發(fā)送 HTTP 請求
使用 GuzzleHttp\Client 發(fā)送請求,并獲取 API 返回的數(shù)據(jù)。
php
<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
function generate_signature($app_key, $app_secret, $timestamp, $params) {
ksort($params);
$sign_str = $app_key . $timestamp . $app_secret;
foreach ($params as $key => $value) {
$sign_str .= $key . $value;
}
return md5($sign_str);
}
function get_product_detail($app_key, $app_secret, $sku_id) {
$timestamp = date('Y-m-d H:i:s');
$params = [
'method' => 'item.get', // 替換為實(shí)際的 API 方法名
'app_key' => $app_key,
'timestamp' => $timestamp,
'v' => '2.0',
'sku' => $sku_id,
'sign_method' => 'md5',
];
$params['sign'] = generate_signature($app_key, $app_secret, $timestamp, $params);
$client = new Client();
$response = $client->request('GET', 'https://api.example.com/routerjson', [
'query' => $params,
]);
if ($response->getStatusCode() == 200) {
return json_decode($response->getBody(), true);
} else {
echo "請求失敗,狀態(tài)碼:" . $response->getStatusCode() . "\n";
return null;
}
}
2. 解析返回的 JSON 數(shù)據(jù)
解析 API 返回的 JSON 數(shù)據(jù),并提取商品的詳細(xì)信息。
php
function parse_response($data) {
if ($data['code'] == '0') {
$items = $data['item_detail_response']['items'];
foreach ($items as $item) {
echo "商品標(biāo)題: " . $item['title'] . "\n";
echo "商品價(jià)格: " . $item['price'] . "\n";
echo "商品圖片: " . $item['pic_url'] . "\n";
echo "商品描述: " . $item['description'] . "\n";
echo "品牌: " . $item['brand'] . "\n";
echo "分類: " . $item['category'] . "\n";
echo "產(chǎn)地: " . $item['origin'] . "\n";
echo "庫存數(shù)量: " . $item['stock_quantity'] . "\n";
echo "銷量: " . $item['sales_volume'] . "\n";
echo "用戶評分: " . $item['rating'] . "\n";
echo "評論數(shù)量: " . $item['comment_count'] . "\n";
if (isset($item['comments'])) {
echo "評論列表:\n";
foreach ($item['comments'] as $comment) {
echo " 用戶名: " . $comment['username'] . "\n";
echo " 評分: " . $comment['rating'] . "\n";
echo " 評論內(nèi)容: " . $comment['comment'] . "\n";
echo " 評論時(shí)間: " . $comment['comment_time'] . "\n";
}
}
if (isset($item['props_list'])) {
echo "商品屬性:\n";
foreach ($item['props_list'] as $key => $value) {
echo " $key: $value\n";
}
}
if (isset($item['sku_list'])) {
echo "SKU 列表:\n";
foreach ($item['sku_list'] as $sku) {
echo " SKU ID: " . $sku['sku_id'] . "\n";
echo " 名稱: " . $sku['name'] . "\n";
echo " 價(jià)格: " . $sku['price'] . "\n";
echo " 庫存: " . $sku['stock'] . "\n";
}
}
if (isset($item['seller_info'])) {
echo "賣家信息:\n";
echo " 賣家 ID: " . $item['seller_info']['seller_id'] . "\n";
echo " 店鋪 ID: " . $item['seller_info']['shop_id'] . "\n";
echo " 店鋪名稱: " . $item['seller_info']['shop_name'] . "\n";
}
echo "商品詳情頁 URL: " . $item['detail_url'] . "\n";
}
} else {
echo "API 請求失敗,錯(cuò)誤信息: " . $data['errorMessage'] . "\n";
}
}
3. 主程序
在主程序中調(diào)用上述函數(shù),獲取并展示商品的詳細(xì)信息。
php
<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
function generate_signature($app_key, $app_secret, $timestamp, $params) {
ksort($params);
$sign_str = $app_key . $timestamp . $app_secret;
foreach ($params as $key => $value) {
$sign_str .= $key . $value;
}
return md5($sign_str);
}
function get_product_detail($app_key, $app_secret, $sku_id) {
$timestamp = date('Y-m-d H:i:s');
$params = [
'method' => 'item.get', // 替換為實(shí)際的 API 方法名
'app_key' => $app_key,
'timestamp' => $timestamp,
'v' => '2.0',
'sku' => $sku_id,
'sign_method' => 'md5',
];
$params['sign'] = generate_signature($app_key, $app_secret, $timestamp, $params);
$client = new Client();
$response = $client->request('GET', 'https://api.example.com/routerjson', [
'query' => $params,
]);
if ($response->getStatusCode() == 200) {
return json_decode($response->getBody(), true);
} else {
echo "請求失敗,狀態(tài)碼:" . $response->getStatusCode() . "\n";
return null;
}
}
function parse_response($data) {
if ($data['code'] == '0') {
$items = $data['item_detail_response']['items'];
foreach ($items as $item) {
echo "商品標(biāo)題: " . $item['title'] . "\n";
echo "商品價(jià)格: " . $item['price'] . "\n";
echo "商品圖片: " . $item['pic_url'] . "\n";
echo "商品描述: " . $item['description'] . "\n";
echo "品牌: " . $item['brand'] . "\n";
echo "分類: " . $item['category'] . "\n";
echo "產(chǎn)地: " . $item['origin'] . "\n";
echo "庫存數(shù)量: " . $item['stock_quantity'] . "\n";
echo "銷量: " . $item['sales_volume'] . "\n";
echo "用戶評分: " . $item['rating'] . "\n";
echo "評論數(shù)量: " . $item['comment_count'] . "\n";
if (isset($item['comments'])) {
echo "評論列表:\n";
foreach ($item['comments'] as $comment) {
echo " 用戶名: " . $comment['username'] . "\n";
echo " 評分: " . $comment['rating'] . "\n";
echo " 評論內(nèi)容: " . $comment['comment'] . "\n";
echo " 評論時(shí)間: " . $comment['comment_time'] . "\n";
}
}
if (isset($item['props_list'])) {
echo "商品屬性:\n";
foreach ($item['props_list'] as $key => $value) {
echo " $key: $value\n";
}
}
if (isset($item['sku_list'])) {
echo "SKU 列表:\n";
foreach ($item['sku_list'] as $sku) {
echo " SKU ID: " . $sku['sku_id'] . "\n";
echo " 名稱: " . $sku['name'] . "\n";
echo " 價(jià)格: " . $sku['price'] . "\n";
echo " 庫存: " . $sku['stock'] . "\n";
}
}
if (isset($item['seller_info'])) {
echo "賣家信息:\n";
echo " 賣家 ID: " . $item['seller_info']['seller_id'] . "\n";
echo " 店鋪 ID: " . $item['seller_info']['shop_id'] . "\n";
echo " 店鋪名稱: " . $item['seller_info']['shop_name'] . "\n";
}
echo "商品詳情頁 URL: " . $item['detail_url'] . "\n";
}
} else {
echo "API 請求失敗,錯(cuò)誤信息: " . $data['errorMessage'] . "\n";
}
}
if (__FILE__ == __FILE__) {
$app_key = 'your_app_key'; // 替換為你的 App Key
$app_secret = 'your_app_secret'; // 替換為你的 App Secret
$sku_id = '123456'; // 替換為商品的 SKU ID
$response_data = get_product_detail($app_key, $app_secret, $sku_id);
if ($response_data) {
parse_response($response_data);
}
}
?>
三、API 返回值說明
商品詳情 API 的返回值是一個(gè) JSON 對象,其結(jié)構(gòu)如下:
返回值示例
JSON
{
"code": "0",
"errorMessage": "success",
"item_detail_response": {
"items": [
{
"sku_id": "1234567890",
"title": "商品標(biāo)題",
"price": "120.00",
"original_price": "150.00",
"discount_price": "100.00",
"pic_url": "https://example.com/image.jpg",
"description": "商品詳細(xì)描述",
"brand": "品牌名稱",
"category": "分類名稱",
"origin": "產(chǎn)地",
"stock_quantity": 100,
"sales_volume": 500,
"rating": 4.5,
"comment_count": 200,
"comments": [
{
"user_id": "user123",
"username": "用戶名",
"rating": 5,
"comment": "好評內(nèi)容",
"comment_time": "2024-10-10T12:00:00Z"
}
],
"props_list": {
"color": "紅色",
"size": "L"
},
"sku_list": [
{
"sku_id": "123456",
"name": "紅色",
"price": "120.00",
"stock": 50
}
],
"seller_info": {
"seller_id": "seller123",
"shop_id": "shop456",
"shop_name": "店鋪名稱"
},
"detail_url": "https://item.example.com/1234567890.html"
}
]
}
}
返回值字段說明
- code:返回的狀態(tài)碼,表示請求的結(jié)果。0 表示成功,其他值表示失敗。
- errorMessage:錯(cuò)誤信息,描述了返回狀態(tài)碼對應(yīng)的錯(cuò)誤原因。
- item_detail_response:商品詳情信息的響應(yīng)數(shù)據(jù)。items:商品列表,包含多個(gè)商品的詳細(xì)信息。sku_id:商品的唯一標(biāo)識 ID。title:商品標(biāo)題。price:商品當(dāng)前價(jià)格。original_price:商品原價(jià)(如果有)。discount_price:商品折扣價(jià)(如果有)。pic_url:商品圖片的 URL。description:商品詳細(xì)描述。brand:商品品牌。category:商品分類。origin:商品產(chǎn)地。stock_quantity:當(dāng)前庫存數(shù)量。sales_volume:銷量。rating:用戶評分。comment_count:評論數(shù)量。comments:評論內(nèi)容列表。user_id:用戶 ID。username:用戶名。rating:用戶評分。comment:評論內(nèi)容。comment_time:評論時(shí)間。props_list:商品屬性列表,如尺碼、顏色等。sku_list:商品的 SKU 列表,每個(gè) SKU 代表一個(gè)具體的商品規(guī)格和價(jià)格組合。sku_id:SKU 的 ID。name:SKU 的名稱。price:SKU 的價(jià)格。stock:SKU 的庫存數(shù)量。seller_info:賣家信息。seller_id:賣家 ID。shop_id:店鋪 ID。shop_name:店鋪名稱。detail_url:商品詳情頁 URL。
四、注意事項(xiàng)
1. API 使用限制
API 提供商可能對請求頻率和數(shù)據(jù)量有限制。建議在實(shí)際使用中合理安排請求間隔,避免被封禁。
2. 數(shù)據(jù)隱私
確保遵守 API 提供商的使用條款,不要濫用數(shù)據(jù)。
3. 異常處理
在請求過程中可能會遇到網(wǎng)絡(luò)問題、API 限制或其他錯(cuò)誤。建議使用 try-catch 語句捕獲異常,并合理處理。
4. 簽名生成
根據(jù) API 文檔,生成簽名是調(diào)用 API 的必要步驟。確保正確實(shí)現(xiàn)簽名生成邏輯。
五、總結(jié)
通過上述步驟和代碼,你可以使用 PHP 爬蟲技術(shù)獲取商品的詳細(xì)信息,并解析返回的 JSON 數(shù)據(jù)。希望這個(gè)示例對你有所幫助!