marketplace

PATCH `/v1/marketplace/listings/{listing_id}`

Edit a Zinn®, or publish it.

身份验证

请将 API 密钥作为 bearer 令牌发送。此端点在规范中未指明具体的权限，因此请为您的密钥赋予所需的最小权限，并通过检查响应来确认，而不是盲目假设。

此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。

免费试用

将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。

curl -X PATCH https://api.zinndigital.com/v1/marketplace/listings/{listing_id} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。在 API 控制台中打开此端点

详细信息

`publish: true` validates every value against the stamped schema version, requires at least one package, recomputes the price cache and takes the listing live — in one transaction, because a listing that went live with a stale price sorts wrongly on every storefront page and quotes a price nobody agreed to, and nothing raises. ⛔ A live Zinn®'s `slug` is permanent: it is the public URL, and changing it breaks every link to it and loses the ranking that link earned. ⛔ A `domain` value is stored in the reveal table, never in `field_values` — the storefront's read path cannot leak what it cannot see (docs/83 §3).

参数

名称	类型	必填	内容简介
`listing_id (path)`	`string`	是	—

请求正文

名称	类型	必填	内容简介
`inclusion_items`	`object[]`	否	The handover checklist a buyer confirms receipt of, for an asset-transfer listing (a website, a domain, a Shopify store). The seller composes it; the listing type's `handover_te…
`title`	`string`	否	—
`summary`	`string`	否	—
`slug`	`string`	否	—
`field_values`	`object`	否	Plain `{key: value}` — the envelope is added by the engine.
`publish`	`boolean`	否	Validate against the stamped schema, require a package, recompute the price cache and go live — in one transaction.
`state`	`string<live, paused, archived>`	否	Take a Zinn® off sale, put it back, or retire it. Applied AFTER any value edit in the same request, so the storefront projection is rebuilt once from the state the listing actua…

响应

名称	类型	必填	内容简介
`id`	`string`	是	—
`vendor_id`	`string`	是	—
`marketplace_id`	`string`	是	—
`marketplace_key`	`string`	是	—
`category_id`	`string`	否	—
`listing_type_id`	`string`	是	—
`listing_type_key`	`string`	是	—
`schema_version`	`integer`	是	The version this listing's values were authored against. Stamped once, never moved — a later schema must not reinterpret an older listing.
`title`	`string`	是	—
`slug`	`string`	是	Permanent once live. It is the public URL.
`summary`	`string`	是	—
`field_values`	`object`	是	"`{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[]`	否	Present on the detail read; the schema THIS listing is authored against.
`state`	`MarketplaceListingState`	是	⛔ `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`	是	—
`price_max_minor`	`integer`	是	—
`currency`	`string`	是	—
`published_at`	`string`	否	—
`packages`	`MarketplacePackage[]`	是	—

此端点可能返回的错误

401 · 404 · 422

PATCH /v1/marketplace/listings/{listing_id}