供应链API
  1. 3 商品
供应链API
  • 使用说明
  • 帮助中心
  • 更新说明
  • V1
    • 1 账号信息
      • 1.1 获取 TOKEN
      • 1.2 重置 TOKEN
      • 1.3 账号基本信息
      • 1.4 设置回调地址
    • 2 基础信息
      • 2.1 省市区列表
      • 2.2 省市区详情
      • 2.3 商品分类
      • 2.4 商品品牌
      • 2.5 所有运输方式
    • 3 商品
      • 3.1 商品列表
        POST
      • 3.2 商品详情
        POST
      • 3.3 商品运输方式
        POST
      • 3.4 商品库存
        POST
      • 3.5 全部在售商品
        POST
    • 4 订单
      • 4.1 运费计算
      • 4.2 订单预览
      • 4.3 订单创建
      • 4.4 订单支付
      • 4.5 订单取消
      • 4.6 订单详情
      • 4.7 确认收货
      • 4.8 运输方式运费
    • 5 售后
      • 5.1 预约服务类型
      • 5.2 上传资源
      • 5.3 创建预约服务
      • 5.4 取消预约服务
      • 5.5 预约服务列表
      • 5.6 预约服务详情
      • 5.7 订单售后详情
    • 6 回调通知
      • 回调通知
  1. 3 商品

3.3 商品运输方式

POST
/api/v1/goods/yf_mode

功能说明#

获取商品支持的运输方式

应用场景#

商品详情页、购物车列表页等,获取商品支持的运输方式

注意事项#

1.
可批量查询,最多每次100个商品
2.
运输方式为快递,则在线收取运费;运输方式为物流时,物流费用线下到付
3.
此接口返回商品支持的所有运输方式,但实际计算运费时,有可能会存在用户的收货地址不配送、禁运、部分运输方式该地区不配送该商品等,所以,使用该接口的正确方式为:首先调用该接口,获取商品所支持的所有运输方式,然后调用运费计算或订单预览,此时其他接口会返回对应的运费,如果选定运输方式该区域不配送,则更换其他运输方式
4.
基于以上,可以直接调用 4.8 运输方式运费 接口返回商品支持所有可用的运输方式及各运输方式的运费;

请求参数

Header 参数

Body 参数application/json

示例
{
    "goodsId": [
        318734,
        318735
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test-openapi.7dingdong.com/api/v1/goods/yf_mode' \
--header 'appKey;' \
--header 'token;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goodsId": [
        318734,
        318735
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "status": 200,
    "msg": "请求成功",
    "requestId": "f7d15c56-3913-11ef-b602-08002763b2f5",
    "content": {
        "success": [
            {
                "goodsId": 318734,
                "yfMode": [
                    {
                        "goodsId": 318734,
                        "yfModeName": "普通快递",
                        "yfModeCode": 1,
                        "yfModeType": 1
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "普通物流-网点自提",
                        "yfModeCode": 2,
                        "yfModeType": 2
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "德邦快递",
                        "yfModeCode": 3,
                        "yfModeType": 1
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "德邦物流-网点自提",
                        "yfModeCode": 4,
                        "yfModeType": 2
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "京东快递",
                        "yfModeCode": 8,
                        "yfModeType": 1
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "京东快运-送货上门",
                        "yfModeCode": 9,
                        "yfModeType": 2
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "京东快运-网点自提",
                        "yfModeCode": 33,
                        "yfModeType": 2
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "顺丰快递",
                        "yfModeCode": 21,
                        "yfModeType": 1
                    },
                    {
                        "goodsId": 318734,
                        "yfModeName": "顺丰快运-送货上门",
                        "yfModeCode": 22,
                        "yfModeType": 2
                    }
                ]
            }
        ],
        "fail": [
            318735
        ]
    }
}
修改于 2024-07-03 12:33:26
上一页
3.2 商品详情
下一页
3.4 商品库存
Built with