Storefront GraphQL API查询元对象

基本信息
接口名称：查询元对象（metaobjects - query）

权限点：unauthenticated_read_metaobjects

版本：20260601

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

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

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

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

对象字段说明 (Fields)

MetaobjectHandleInput（输入结构）

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

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

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Storefront GraphQL API查询元对象

请求参数

请求示例代码

返回响应