marketplace
GET /v1/marketplace/{vertical}/{slug}
One live Zinn®, as anyone sees it.
身份验证
请将 API 密钥作为 bearer 令牌发送。此端点在规范中未指明具体的权限，因此请为您的密钥赋予所需的最小权限，并通过检查响应来确认，而不是盲目假设。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/marketplace/{vertical}/{slug} \
-H "Authorization: Bearer zdk_live_…"已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
Anonymous and SINGLE-VARIANT. No user-agent branch, no Vary: Cookie, no signed-in mode — docs/83 §3's rule is that Googlebot must see exactly what an anonymous visitor sees. A domain renders as site****.com; a url or file does not render at all. The full value is not in the tables this reads. ⛔ An unknown field kind is SKIPPED, never degraded to text: a page served by a newer engine than the deployed bundle must not print 12000 for a money field whose truth is $120.00, because a visitor has no way to tell a wrong number from a right one. ⛔ A listing whose stamped schema version has no history row is a 404, not a render against the type's current head. Quietly showing different facts is worse than showing nothing.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
vertical (path) | string | 是 | — |
slug (path) | string | 是 | — |
locale (query) | string | 否 | Render every operator-authored string — field labels, help text, enum option labels — in this locale, falling back to the source language per string. ⛔ A query parameter rather… |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
source_locale | string | 否 | The language the seller wrote this listing in (#2606 slice E), or "" when nothing has been translated and the question does not arise. ⭐ The owner's ruling was… |
copy_locale | string | 否 | The language title and summary are actually IN — the requested locale when a translation was served, "" when they are the seller's own words. ⛔ Not the locale that was asked… |
id | string | 是 | — |
slug | string | 是 | — |
title | string | 是 | — |
summary | string | 是 | — |
marketplace_key | string | 是 | — |
images | MarketplaceImage[] | 否 | Cover first, so a client that renders only the first entry renders the right one without knowing the rule. Empty until the seller uploads one. |
storefront_layout | MarketplaceStorefrontLayout | 否 | How a vertical's results are laid out on the public storefront. Owner instruction 2026-08-08:… |
category_path | string | 否 | — |
listing_type_key | string | 是 | — |
schema_version | integer | 是 | — |
vendor_display_name | string | 是 | The Zinner®'s public name — never the legal name held for identity checks. |
price_minor | integer | 是 | — |
price_max_minor | integer | 是 | — |
currency | string | 是 | — |
sales_count | integer | 是 | — |
published_at | string | 否 | — |
fields | MarketplacePublicField[] | 是 | — |
packages | MarketplacePackage[] | 是 | — |
此端点可能返回的错误
404