GET https://{handle}.myshopline.com/admin/openapi/v20260301/:p_resource/:p_owner_id/:resource/:owner_id/metafields.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handleopen001
批量查询元字段。
DEPRECATED
该接口自 API v20250601 起废弃。使用 批量查询元字段 接口替代。
路径参数
  • p_resource string required
    一级资源,如products
    例子: products
  • owner_id string required
    二级资源id
    例子: 1802351351232521351351
  • resource string required
    二级资源,如variants
    例子: variants
  • p_owner_id string required
    一级资源id
    例子: 16024213413413412341234
查询参数
  • created_at_min string
    显示在日期之后创建的元字段
    例子: 2021-04-25T16:15:47-04:00
  • key string
    元字段在其 namespace 下的唯一标识符。
    例子: key_123
  • since_id string
    将结果限制在指定 ID 之后
    例子: 1
  • type string
    元字段类型
    例子: single_line_text_field
  • namespace string
    命名空间
    例子: n_123
  • created_at_max string
    显示在日期之前创建的元字段
    例子: 2021-04-25T16:16:47-04:00
  • fields string
    要包含在响应中的以逗号分隔的字段列表
    例子: id,key
  • limit string
    查询数量限制,默认50,不能超过1000
    例子: 30
  • updated_at_max string
    显示在日期之前更新的元字段
    例子: 2021-04-25T16:16:47-04:00
  • updated_at_min string
    显示在日期之后更新的元字段
    例子: 2021-04-25T16:15:47-04:00
  • page_info string
    分页查询的唯一标识,用于定位特定页面。
    该字段值需要在你已经查询完分页信息后,在该接口响应头中的 link 字段值中获取。例如,你获取到的 link 的值为 <https://{handle}.myshopline.com/admin/openapi/{version}/:p_resource/:p_owner_id/:resource/:owner_id/metafields.json?limit=1&page_info=eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9>; rel="next" ,那么 page_info 的值为 eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9
    关于更多如何使用分页信息,请参考 分页机制
    例子: 32fascxga32fasdf234234sdafsf
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8
  • Authorization string required
    资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。
    例子:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
状态码
更多状态码信息,参考 HTTP 状态码

响应头
  • link
    提供分页数据的 URL 链接。你可以获取该字段值中的 page_info 信息用于下一次分页请求中。
    当你请求的页面存在上一页或下一页的时候,该字段会被返回。关于更多如何使用分页信息,请参考 分页机制
  • traceId
    请求的全局唯一标识符。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
  • metafieldsobject[]
    元字段
  • created_at string
    创建时间
    例子: 2022-12-28T09:48:09+00:00
  • description string
    描述
    例子: 234212423
  • id long
    元字段的id
    例子: 398100698691
  • key string
    元字段在其 namespace 下的唯一标识符。
    例子: key_123
  • namespace string
    命名空间
    例子: n_123
  • owner_id string
    资源id
    例子: 1802351351232521351351
  • owner_resource string
    资源
    例子: variants
  • type string
    类型
    例子: single_line_text_field
  • updated_at string
    更新时间
    例子: 2022-12-28T09:46:24+00:00
  • value object
    元字段值
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

path required
path required
path required
path required
header required
query
query
query
query
query
query
query
query
query
query
query

Language

curl --request GET \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/p_resource/p_owner_id/resource/owner_id/metafields.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json'
Examples
返回所有字段
Response
{
"metafields": [
{
"created_at": "2022-12-28T09:46:24+00:00",
"description": "desc",
"id": 398100698691,
"key": "key_123",
"namespace": "namespace_123",
"owner_id": "1802351351232521351351",
"owner_resource": "variants",
"type": "single_line_text_field",
"updated_at": "2022-12-28T10:19:29+00:00",
"value": "update"
}
]
}
这篇文章对你有帮助吗?