Storefront GraphQL API批量查询元对象

接口名称：批量查询元对象

权限点：unauthenticated_read_metaobjects

版本：20260601

描述：分页查询元对象。

入参说明 (Input)
after [String, 选填]：返回指定游标之后的元素。如果指定了该参数，也必须要同时指定 first 参数。

before [String, 选填]：返回指定游标之前的元素。如果指定了该参数，也必须要同时指定 last 参数。

first [Int, 选填]：返回列表中的前 n 个元素。

last [Int, 选填]：返回列表中的最后 n 个元素。

reverse [Boolean, 选填]：是否反转列表的顺序。true 为反转，false 为不反转。默认值：false。

sortKey [String, 选填]：用于排序的字段，多个字段用逗号分隔。可指定的字段有：id, type, updated_at, display_name。

type [String, 必填, 非空]：要查询的元对象的类型。

出参说明 (Output / Possible Returns)
edges [MetaobjectEdge, 非空]：当前页面数据的游标和节点信息列表。

nodes [Metaobject, 非空]：包含元对象的节点。

pageInfo [PageInfo, 非空]：分页，公共字段，可查看：PageInfo。

对象字段说明 (Fields)

MetaobjectEdge（边缘节点对象）

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

node [Metaobject, 非空]：元对象的节点信息列表。

Metaobject (3.3.3 Metaobject - Object)

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

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

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

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

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

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

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "query": "query MyQuery($type: String!, $after: String, $before: String, $first: Int, $last: Int, $reverse: Boolean, $sortKey: String) { metaobjects(type: $type, after: $after, before: $before, first: $first, last: $last, reverse: $reverse, sortKey: $sortKey) { pageInfo { endCursor hasNextPage hasPreviousPage startCursor } edges { cursor node { createdAt fields { value type key } updatedAt type id handle } } } }",
  "variables": {
    "type": "product_specification3",
    "after": null,
    "before": 10,
    "first": null,
    "last": 10,
    "reverse": false,
    "sortKey": "updated_at"
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Storefront GraphQL API批量查询元对象

请求参数

请求示例代码

返回响应