阿里巴巴中国站获得商品快递费用 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参数明文传输，若要加密请参考：https://open.cn/help/demo/sdk/demo-sign.php
$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"
}

六、错误码解释