更新元对象定义

PUT

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

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

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

{
    "metaobject_definition": {
        "name": "更新后的元对象名称",
        "description": "更新后的描述",
        "field_definitions": [
            {
                "operation": "CREATE",
                "name": "新字段",
                "key": "description61",
                "type": "single_line_text_field"
            },
            {
                "operation": "UPDATE",
                "key": "title2121",
                "name": "更新后的标题12"
            },
            {
                "operation": "CREATE",
                "name": "新字段",
                "key": "description63",
                "type": "single_line_text_field"
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://zhenghaonan.myshopline.com/admin/openapi/v20260601/metaobject_definition.json?id=23720690033' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzJiODI1NDQzNzg0ZjIwMGRlZTI3MzM4MDA3ZWQ3MDYyNmM3NzBhZSIsImV4cCI6MTg2MDgwNzQ2NywiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjI0MDczMzE4NjIiLCJzdG9yZUlkIjoiMTczNjQxNjA5MDAzMyIsInRpbWVzdGFtcCI6MTc2NjExMzA2NzQyMiwidmVyc2lvbiI6IlYyIn0.ZbMED6-ll35NSPOxQg55TreKpqGIHLq-NbJg3L9vSU4AuXIZ7TTuEjsqkRwmbcGSR_pyX3k77ka8b04_BnM46Q' \
--header 'Content-Type: application/json' \
--data '{
    "metaobject_definition": {
        "name": "更新后的元对象名称",
        "description": "更新后的描述",
        "field_definitions": [
            {
                "operation": "CREATE",
                "name": "新字段",
                "key": "description61",
                "type": "single_line_text_field"
            },
            {
                "operation": "UPDATE",
                "key": "title2121",
                "name": "更新后的标题12"
            },
            {
                "operation": "CREATE",
                "name": "新字段",
                "key": "description63",
                "type": "single_line_text_field"
            }
        ]
    }
}'

返回响应

🟢200

成功

该响应没有 Body

🟠400

🟠404

修改于 2026-04-16 02:32:33

创建元对象定义

查询单个元对象定义