一、应用场景
阿里巴巴中国站获得商品快递费用 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"
}
六、错误码解释