系统物流-详细

物流 - 获取物流方案详情

接口信息

• 接口地址: {your-site-url}/api/skill/shipping/get-shipping-info
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取指定物流方案的详细信息，包含该方案下的所有配送区域（zones）。

认证

请求头中需要携带 skill-access-token：

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/shipping/get-shipping-info?id=26' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "id": 26,
        "shop_id": 15,
        "name": {
            "text": "这是物流名称",
            "lang_params": {
                "cn": "这是物流名称",
                "en": "This is the logistics name",
                "ja": "これは物流名です",
                "fi": "Tämä on logistiikan nimi.",
                "lo": "ນີ້ ເປັນ ຊື່ຊັ່ນ",
                "id": "Ini namanya logistik",
                "sv": "Detta är logistiknamnet.",
                "pl": "To jest nazwa logistyczna"
            }
        },
        "priority": 1,
        "status": 2,
        "created_at": "2023-03-18 06:46:09",
        "updated_at": "2026-01-08 17:02:37",
        "zones": [
            {
                "id": 95,
                "shop_id": 15,
                "shipping_id": 26,
                "name": "china",
                "countries": [
                    {
                        "country": "CN",
                        "province": ["AH", "BJ", "CQ", "FJ", "GS", "GD"]
                    }
                ],
                "type": 1,
                "weight_based_shipping_rates": [
                    {"start": 0, "end": "1000022", "amount": "12"}
                ],
                "price_based_shipping_rates": [],
                "qty_based_shipping_rates": {
                    "is_free_shipping": 2,
                    "fist_item": "",
                    "each_additional_item": "",
                    "is_over_qty_free_shipping": 2,
                    "over_qty": ""
                },
                "created_at": 1758592090,
                "updated_at": 1758592090
            }
        ]
    },
    "message": "success"
}

返回字段说明

data — 物流方案字段

zones 子项 — 配送区域字段

计费规则子项（weight_based / price_based）

qty_based_shipping_rates 字段

注意事项

1. GET 请求，id 通过 query string 传递
2. zones 数组包含该物流方案下所有配送区域，各区域的计费规则按 type 分类
3. name.lang_params 无其他语言数据时返回空数组 []，有数据时返回对象 {}