Product Info API 文档

商品-详情

接口信息

• 接口地址: {your-site-url}/api/skill/product/info
• 基础 URL: {your-site-url} 需替换为你自己的 fecify 独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• Content-Type: application/json
• 说明: 此接口为查询接口，用于获取单个商品的详细信息

认证

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

请求参数 (Query String)

请求示例

cURL

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

返回结果

成功响应

{
    "code": 200,
    "data": {
        "id": 4625,
        "shop_id": 15,
        "handle": "morden-lighting-nordic-white-black-lamp-shade-floor-lamp-wooden-support-standing-light",
        "spu": "7218747113643",
        "title": "Nordic White Black Lamp Floor Lamp Wooden Standing",
        "sub_title": "",
        "body_html": "...",
        "feed_title": "",
        "feed_description": null,
        "meta_is_edit": 1,
        "meta_title": "Nordic White Black Lamp Floor Lamp Wooden Standing",
        "meta_keywords": "",
        "meta_description": "...",
        "status": 1,
        "availability": 1,
        "virtual_sales_count": 0,
        "type": 2,
        "is_tax": 2,
        "vendor": "Lighting Made",
        "qty": 198,
        "price": "470.00",
        "compare_at_price": "500.00",
        "sale_count": 0,
        "final_sale_count": 0,
        "created_at": "2026-02-08 10:35:42",
        "updated_at": "2026-05-05 11:10:19",
        "is_deleted": 2,
        "deleted_at": 0,
        "inventory_police": 1,
        "inventory_police_type": 1,
        "variant_need_image": 1,
        "variant_show_image": 3,
        "variant_need_note": 1,
        "note": "",
        "translate_type": 3,
        "remote_id": "7218747113643",
        "google_product_category": 0,
        "google_product_type_id": 0,
        "description_json_status": 2,
        "description_json": [],
        "params_json_status": 2,
        "params_json": [],
        "short_description_json": [],
        "source_id": "",
        "source_url": "",
        "source_type": 0,
        "template_type": "",
        "variants": [
            {
                "id": 42432,
                "shop_id": 15,
                "product_id": 4625,
                "title": "White",
                "price": "470.00",
                "compare_at_price": "500.00",
                "cost_price": "0.00",
                "wholesale_price": [
                    { "qty": 2, "price": "38.99" },
                    { "qty": 5, "price": "18.99" }
                ],
                "sku": "LM4540066",
                "gram": 2267,
                "position": 0,
                "barcode": "",
                "image_id": 30233,
                "qty": 98,
                "option1": "White",
                "option2": "",
                "option3": "",
                "weight": "5.00",
                "weight_unit": "lb",
                "sale_count": 0,
                "note": "",
                "created_at": "2026-02-08 10:35:42",
                "updated_at": "2026-05-05 11:10:20",
                "remote_id": 0,
                "source_id": "",
                "image": "/product/15/image/2026/02/08/1e0c57ae313ecb06f730ee2e27f31c42.jpg",
                "customervip": [
                    { "id": 80, "product_id": 4625, "variant_id": 42432, "customervip_id": 11, "price": "15.00", "compare_at_price": "0.00" }
                ],
                "images": [],
                "buy_min_count": 0
            }
        ],
        "options": [
            {
                "id": 5135,
                "shop_id": 15,
                "product_id": 4625,
                "name": "Lampshade Color",
                "position": 1,
                "items": ["White", "Black"],
                "created_at": "2026-02-08 10:35:42",
                "updated_at": "2026-02-08 10:35:42"
            }
        ],
        "images": [
            {
                "id": 30232,
                "product_id": 4625,
                "position": 1,
                "src": "/product/15/image/2026/02/08/90667114713397b934d471526f73bfd4.jpg",
                "alt": "",
                "width": 800,
                "height": 800,
                "ratio": "1.00"
            }
        ],
        "videos": [],
        "collectionIds": [343, 327, 322, 344, 345],
        "tagIds": [
            {
                "product_id": 4625,
                "tag_id": 10,
                "tag": { "title": "red", "id": 10, "first_letter": "r" }
            }
        ],
        "mergeimages": [
            {
                "id": 151,
                "product_id": 4625,
                "position": 1,
                "src": "/product/15/image/2026/05/05/9407d10ebdb8a96ad9b77501dad22b8c.png",
                "width": 533,
                "height": 800,
                "ratio": "0.67",
                "alt": ""
            },
            {
                "id": 152,
                "product_id": 4625,
                "position": 2,
                "src": "/product/15/image/2026/05/05/2993e6d5a772aa0d057234dbbfecf639.png",
                "width": 800,
                "height": 760,
                "ratio": "1.05",
                "alt": ""
            }
        ],
        "payafteruse": { "id": 9, "product_id": 4625, "type": 2 },
        "glasses_attr": { "id": 446, "shop_id": 15, "product_id": 4625, "...": "..." },
        "addition_group_id": "",
        "productattr_info": []
    },
    "message": "success"
}

返回字段说明

data 顶层字段

data 顶层字段 - SEO 相关

data 顶层字段 - Feed 相关

data 顶层字段 - 同步与来源

data 顶层字段 - 描述/参数 JSON

data 顶层字段 - 其他

data.variants（产品变体/规格）

当为单规格产品时，该数组只有一个子项。

wholesale_price 子字段

wholesale_price 是一个数组，每个元素包含：

示例：

"wholesale_price": [
    { "qty": 2, "price": "38.99" },
    { "qty": 5, "price": "18.99" }
]

customervip 子字段

customervip 是一个数组，每个元素包含：

data.options（产品规格定义）

单规格产品为空，多规格产品不为空。

data.images（产品图片）

data.videos（产品视频）

data.collectionIds

data.tagIds

data.payafteruse（先用后付）

data.glasses_attr（眼镜属性）

data.mergeimages（合并图片）

注意事项

1. id 为必填参数，不传或传无效 ID 将返回错误
2. 该接口返回商品的完整信息，包含变体、规格、图片、专辑、标签、VIP价格等所有关联数据
3. variants[].customervip 仅在站点启用了 VIP 会员功能时返回有效数据
4. wholesale_price 为变体的批发价格数组，每个元素包含 qty（起批数量）和 price（批发单价）
5. weight_unit 支持 g、kg、lb、oz 四种单位
6. remote_id 用于与三方系统（如 ERP）同步商品数据时，记录三方系统的商品 ID
7. glasses_attr 为眼镜类商品的专有属性，普通商品返回空数据