阿里巴巴中國站獲得商品快遞費用 API 返回值說明

一、應用場景

阿里巴巴中國站獲得商品快遞費用 API（1688.item_fee）通常用於查詢商品的快遞費用。這個API的應用場景包括但不限於以下幾個方面：

1、電商平臺：在電商平臺上，當使用者購買商品時，需要知道商品的快遞費用。透過呼叫這個API，電商平臺可以實時獲取商品的快遞費用，並在頁面上展示給使用者，從而提高使用者的購物體驗。

2、物流管理系統：對於物流公司或者需要管理大量物流資訊的企業來說，可以透過呼叫這個API，自動獲取商品的快遞費用，並將其納入物流管理系統中，實現物流成本的自動計算和管理。

3、價格比較工具：有些工具或者平臺會提供商品價格比較服務，包括商品價格和快遞費用。透過呼叫這個API，這些工具或者平臺可以獲取到商品的快遞費用，從而為使用者提供更全面的價格比較資訊。

需要注意的是，具體的應用場景還需要根據具體的業務需求和技術實現來確定。同時，使用API時也需要遵守阿里巴巴的API文件和授權要求。

二、公共引數

請求地址:https://api-gw.cn/1688/item_fee

三、請求引數

請求引數：num_iid=577523351572&area_id=650100&temp_id=15315901&nick=盈龍服飾&location=14127178&unitweight=0.8

引數說明：num_iid:商品ID

area_id:收貨區域ID(郵政編碼)

location:發貨區域ID(郵政編碼)

nick:店鋪暱稱

location:發貨區域ID

temp_id:運費模板ID(item_get_app介面的subTemplateId欄位)

unitweight:重量(item_get_app介面的unitWeight欄位)

四、請求示例

<?php
// 請求示例 url 預設請求引數已經URL編碼處理
// 本示例程式碼未加密secret引數明文傳輸，若要加密請參考：
$method = "GET";
$url = "https://api-gw.cn/1688/item_fee/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=577523351572&area_id=650100&temp_id=15315901&nick=盈龍服飾&location=14127178&unitweight=0.8";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

五、響應示例

{
	"item": {
		"num_iid": "624499968344",
		"location": "13543512",
		"area_id": "2274",
		"price": 4.5,
		"url": "https://detail.1688.com/offer/624499968344.html?",
		"_ddf": "1688pc"
	},
	"secache": "905bbd1ad4e6a9a7504fd71154872702",
	"secache_time": 1698283242,
	"secache_date": "2023-10-26 09:20:42",
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:155 max:10055 all[773=155+118+501];expires:2030-12-31",
	"execution_time": "1.064",
	"server_time": "Beijing/2023-10-26 09:20:42",
	"client_ip": "182.108.169.231",
	"call_args": {
		"num_iid": "624499968344",
		"area_id": "2274",
		"sku": "13012984"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "3.98MB",
	"request_id": "gw-1.6539bee9c24a5",
	"last_id": "2218697830"
}

六、錯誤碼解釋