1. 元对象(Metaobject) API
个人项目
  • 元对象(Metaobject) API
    • Storefront GraphQL API批量查询元对象
      POST
    • 创建元对象定义
      POST
    • 更新元对象定义
      PUT
    • 查询单个元对象定义
      GET
    • 删除元对象定义
      DELETE
    • 分页查询元对象定义
      GET
    • 创建元对象
      POST
    • 更新元对象
      PUT
    • 查询单个元对象
      GET
    • 删除元对象
      DELETE
    • 批量查询元对象
      GET
    • Storefront GraphQL API查询元对象
      POST
  1. 元对象(Metaobject) API

更新元对象

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
上一页
创建元对象
下一页
查询单个元对象
Built with