marketplace

POST /v1/marketplace/listings

Start a Zinn®.

Dhammaan marketplace bixiyayaasha

Xaqiijinta aqoonsiga

U dir fure API ahaan calaamad muujisa (bearer token). Barta dhammaadka ee kani ma caysino luqad ahaan oggolaansho gaar ah oo ku dhex jirta qeexidda, markaa sii furahaaga inta ugu yar ee uu u baahan yahay oo fiiri jawaabta halka aad wax ka qaadan lahayd.

Boggan ma qaato aqoonsiga ururka. Furahaagu wuxuu horay u aqoonsanayaa ururka uu ka tirsan yahay, jawaabtuna waxay ku kooban tahay halkaas.

Isku day

Ku beddel wax kasta oo ku dhex jira qeebaha xaglaha ah qiimayaashaada, sidoo kalena haystaaha furaha ku beddel fure ka dhex muuqda dashboordigaaga.

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> }'

Ma sign-garaysay? Qalabka API ee ku jira dashboard-kaagu wuxuu buuxiyaa aqoonsigaaga ururka ee dhabta ah iyo furahaaga gaarka ah, wuxuuna ku shaqeysiiyaa codsiga API-ga nool si aad u aragto jawaabta dhabta ah. Kani ka fur barta kontoroolka ee API

Details

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.

Codsiga jidhkiisa

MagacaNoocLoo baahan yahayMaxay tahay
listing_type_idstringHaa
category_idstringMaya
titlestringHaa
summarystringMaya

Jawaab

MagacaNoocLoo baahan yahayMaxay tahay
idstringHaa
vendor_idstringHaa
marketplace_idstringHaa
marketplace_keystringHaa
category_idstringMaya
listing_type_idstringHaa
listing_type_keystringHaa
schema_versionintegerHaaThe version this listing's values were authored against. Stamped once, never moved — a later schema must not reinterpret an older listing.
titlestringHaa
slugstringHaaPermanent once live. It is the public URL.
summarystringHaa
field_valuesobjectHaa"`{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[]MayaPresent on the detail read; the schema THIS listing is authored against.
stateMarketplaceListingStateHaa⛔ `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_minorintegerHaa
price_max_minorintegerHaa
currencystringHaa
published_atstringMaya
packagesMarketplacePackage[]Haa

Cilladaha ay bartaani soo celin karto

401 · 409 · 422