marketplace
GET /v1/marketplace/{vertical}/{slug}
One live Zinn®, as anyone sees it.
Πισtoποίηση
Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Αυτό το τελικό σημείο δεν ορίζει μια συγκεκριμένη άδεια στην προδιαγραφή, οπότε δώστε στο κλειδί σας τα ελάχιστα δυνατά δικαιώματα και ελέγξτε την απόκριση αντί να κάνετε υποθέσεις.
Αυτό το τελικό σημείο δεν δέχεται αναγνωριστικό οργανισμού. Το κλειδί σας προσδιορίζει ήδη τον οργανισμό στον οποίο ανήκει, και η απάντηση περιορίζεται σε αυτόν.
Δοκιμάστε το
Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.
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.
Παράμετροι
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
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… |
Απάντηση
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
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