marketplace

POST `/v1/marketplace/listings`

Start a Zinn®.

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 POST https://api.zinndigital.com/v1/marketplace/listings \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "listing_type_id": <string>, "title": <string> }'

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

Creates a draft. The listing type's CURRENT schema version is stamped onto it here, once, and never moved — tightening the type's schema later must not retroactively invalidate what was authored under the old one (docs/78 §4.2 trap 2). ⛔ The Zinner® must be `approved`. docs/78 §3.2 makes `under_review` the anti-fraud gate rather than a formality, and an account that can author listings while under review has walked straight through it.

Treść żądania

Nazwa	Typ	Wymagane	Co to jest
`listing_type_id`	`string`	Tak	—
`category_id`	`string`	Nie	—
`title`	`string`	Tak	—
`summary`	`string`	Nie	—

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`id`	`string`	Tak	—
`vendor_id`	`string`	Tak	—
`marketplace_id`	`string`	Tak	—
`marketplace_key`	`string`	Tak	—
`category_id`	`string`	Nie	—
`listing_type_id`	`string`	Tak	—
`listing_type_key`	`string`	Tak	—
`schema_version`	`integer`	Tak	The version this listing's values were authored against. Stamped once, never moved — a later schema must not reinterpret an older listing.
`title`	`string`	Tak	—
`slug`	`string`	Tak	Permanent once live. It is the public URL.
`summary`	`string`	Tak	—
`field_values`	`object`	Tak	"`{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_schema`	`MarketplaceFieldDefinition[]`	Nie	Present on the detail read; the schema THIS listing is authored against.
`state`	`MarketplaceListingState`	Tak	⛔ `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_minor`	`integer`	Tak	—
`price_max_minor`	`integer`	Tak	—
`currency`	`string`	Tak	—
`published_at`	`string`	Nie	—
`packages`	`MarketplacePackage[]`	Tak	—

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

401 · 409 · 422

POST /v1/marketplace/listings