## 获取商品的默认物流配送资费(goodsLogistics) >[info] 场景说明:商品详情页面,显示该商品的默认(参考)物流配送费用,可传入地址ID检索该地区的物流资费 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/goods/logistics ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 访问TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | goods\_id | integer | 必须 | 商品ID | | city\_id | integer | 可选 | 目的地城市ID,为空或不传则系统自动获取访客所在城市ID(如获取不到则取默认地区资费) | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "goods_id": 1, "city_id": 123 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 物流信息列表 | | └ region | array | 必须 | 目的地信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | type | string | 必须 | 物流类型,取值:"express"=快递、"ems"=EMS、"post"=平邮 | | name | string | 必须 | 物流名称 | | start\_standards | integer | 必须 | 首件标准,默认1 | | start\_fees | decimal | 必须 | 首件运费/件 | | add\_standards | integer | 必须 | 续件标准,默认1 | | add\_fees | decimal | 必须 | 续件运费/件 | 返回`data->region`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | region\_id | intger | 必须 | 目的地ID | | region\_name | string | 必须 | 目的地名称 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "type": "express", "name": "快递", "start_standards": 1, "start_fees": 10.00, "add_standards": 1, "add_fees": 8, }, { "type": "ems", "name": "EMS", "start_standards": 1, "start_fees": 12.00, "add_standards": 1, "add_fees": 8, }, { "type": "post", "name": "平邮", "start_standards": 1, "start_fees": 5.00, "add_standards": 1, "add_fees": 5, }, ], "region": { "region_id": 123, "region_name": "北京" } } } ```