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

Storefront GraphQL API查询元对象

POST
https://zhenghaonan.myshopline.com/storefront/graph/v20260601/graphql.json

基本信息
接口名称:查询元对象(metaobjects - query)

权限点:unauthenticated_read_metaobjects

版本:20260601

描述:查询指定的元对象。

入参说明 (Input)
id [类型: ID]:元对象的 ID。

handle [类型: MetaobjectHandleInput]:元对象的 handle 和类型。

出参说明 (Output)
Metaobject [类型: Metaobject]:返回指定的元对象。

对象字段说明 (Fields)

  1. MetaobjectHandleInput(输入结构)

handle [String, 非空]:元对象的唯一句柄,可用作自定义 ID,支持修改。

type [String, 非空]:元对象的类型。

  1. Metaobject(返回结构)

id [String, 非空]:元对象的唯一标识符。

handle [String, 非空]:元对象的唯一句柄,可用作自定义 ID,支持修改。

type [String, 非空]:元对象的类型。

displayName [String, 非空]:元对象定义的显示名称。

updatedAt [DateTime, 非空]:元对象最近一次更新的时间。

createdAt [DateTime, 非空]:元对象创建时间。

fields [List, 非空]:元对象定义的字段的列表。

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "query": "query MyQuery($handle: MetaobjectHandleInput, $id: String) { metaobject(handle: $handle, id: $id) { createdAt fields { key type value } handle id type updatedAt } }",
  "variables": {
    "handle": {
      "type": "product_specification3",
      "handle": "object_748710033"
    },
    "id": "gid://shopline/Metaobject/22402660033"
  }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://zhenghaonan.myshopline.com/storefront/graph/v20260601/graphql.json' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ5c291bCIsInRva2VuIjoiNzJiODI1NDQzNzg0ZjIwMGRlZTI3MzM4MDA3ZWQ3MDYyNmM3NzBhZXw5NDIyMHwxNzM2NDE2MDkwMDMzfDE3NjYxMTMwNjd8MjA2NDU1NzM2MHwifQ.1uDV5Vj4aTWIAJvYn70Vn2hOL2AhWQcsNoMvOIFBTYn_tm-_vim_mUBv1wI5ZorXsYsihRxQi_6jvGt0Nvys5g' \
--header 'Content-Type: application/json' \
--data '{
  "query": "query MyQuery($handle: MetaobjectHandleInput, $id: String) { metaobject(handle: $handle, id: $id) { createdAt fields { key type value } handle id type updatedAt } }",
  "variables": {
    "handle": {
      "type": "product_specification3",
      "handle": "object_748710033"
    },
    "id": "gid://shopline/Metaobject/22402660033"
  }
}'

返回响应

🟢200
成功
该响应没有 Body
修改于 2026-04-16 03:46:14
上一页
批量查询元对象
Built with