marketplace
GET /v1/marketplace/{vertical}/{slug}
One live Zinn®, as anyone sees it.
인증
Bearer 토큰으로 API 키를 전송하세요. 이 엔드포인트는 명세에 특정 권한을 명시하지 않으므로, 가정하기보다는 키에 필요한 최소한의 권한을 부여하고 응답을 확인하세요.
이 엔드포인트는 조직 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 *"translate… |
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 ask… |
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: *"layouts suited to what is sold — a guest post is a list/table, not a product card… |
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