marketplace

GET /v1/marketplace/listings/{listing_id}

One of this account's Zinn®s, with the schema it is authored against.

Wszystkie punkty końcowe marketplace

Uwierzytelnianie

Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X GET https://api.zinndigital.com/v1/marketplace/listings/{listing_id} \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

`field_schema` is the version stamped on THIS listing, not the type's current head — so a form built from it edits the listing as it actually is.

Parametry

NazwaTypWymaganeCo to jest
listing_id (path)stringTak

Odpowiedź

NazwaTypWymaganeCo to jest
idstringTak
vendor_idstringTak
marketplace_idstringTak
marketplace_keystringTak
category_idstringNie
listing_type_idstringTak
listing_type_keystringTak
schema_versionintegerTakThe version this listing's values were authored against. Stamped once, never moved — a later schema must not reinterpret an older listing.
titlestringTak
slugstringTakPermanent once live. It is the public URL.
summarystringTak
field_valuesobjectTak"`{key: {v, ver}}`" — uniform two keys, `ver: null` for a seller-declared value, so no consumer branches on key presence. ⛔ A `domain` value is NOT here — it is in the reveal ta…
field_schemaMarketplaceFieldDefinition[]NiePresent on the detail read; the schema THIS listing is authored against.
stateMarketplaceListingStateTak⛔ `archived`, never deleted. A listing that sold has public URLs, backlinks and an order behind it, and a 404 costs rankings that do not come back.
price_minorintegerTak
price_max_minorintegerTak
currencystringTak
published_atstringNie
packagesMarketplacePackage[]Tak

Błędy, które ten punkt końcowy może zwrócić

401 · 404