marketplace
GET /v1/marketplace/{vertical}/{slug}
One live Zinn®, as anyone sees it.
احراز هویت
یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمیکند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/marketplace/{vertical}/{slug} \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی 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