更新元对象

PUT

https://zhenghaonan.myshopline.com/admin/openapi/v20260601/metaobject.json

● 接口名称
○ 中文：更新元对象
○ 英文：Update a metaobject
● 接口描述
○ 中文：
更新元对象。对于接口中的非必填字段：
● 若传入空字符串，将清空对应字段的值。
● 如果不传字段，或者传入null，系统将保留字段值，不做更新。
○ 英文：Update metaobject definitions.
○ 英文：Update a metaobject.
● 接口信息
○ 权限点：write_metaobject。
○ 接口地址：/metaobject.json
○ 请求方法：PUT

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "metaobject": {
        "handle": "updated-handle",
        "fields": [
            {
                "key": "title2121",
                "value": "颜色规格"
            },
            {
                "key": "description",
                "value": "颜色规格121"
            },
            {
                "key": "description2",
                "value": "这是一个颜色规格的描述"
            }
        ],
        "capabilities": {
            "publishable": {
                "status": "DRAFT"
            }
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://zhenghaonan.myshopline.com/admin/openapi/v20260601/metaobject.json?id=22423610033' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzJiODI1NDQzNzg0ZjIwMGRlZTI3MzM4MDA3ZWQ3MDYyNmM3NzBhZSIsImV4cCI6MTg2MDgwNzQ2NywiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjI0MDczMzE4NjIiLCJzdG9yZUlkIjoiMTczNjQxNjA5MDAzMyIsInRpbWVzdGFtcCI6MTc2NjExMzA2NzQyMiwidmVyc2lvbiI6IlYyIn0.ZbMED6-ll35NSPOxQg55TreKpqGIHLq-NbJg3L9vSU4AuXIZ7TTuEjsqkRwmbcGSR_pyX3k77ka8b04_BnM46Q' \
--header 'Content-Type: application/json' \
--data '{
    "metaobject": {
        "handle": "updated-handle",
        "fields": [
            {
                "key": "title2121",
                "value": "颜色规格"
            },
            {
                "key": "description",
                "value": "颜色规格121"
            },
            {
                "key": "description2",
                "value": "这是一个颜色规格的描述"
            }
        ],
        "capabilities": {
            "publishable": {
                "status": "DRAFT"
            }
        }
    }
}'

返回响应

🟢200

成功

该响应没有 Body

🟠400

🟠404

修改于 2026-04-16 03:25:35

创建元对象

查询单个元对象