marketplace

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

Edit a Zinn®, or publish it.

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Dieser Endpunkt gibt in der Spezifikation keine spezifische Berechtigung an. Versehen Sie Ihren Schlüssel daher mit den minimal erforderlichen Rechten und prüfen Sie die Antwort, anstatt Annahmen zu treffen.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

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

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

`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).

Parameter

Name	Typ	Erforderlich	Was es ist
`listing_id (path)`	`string`	Ja	—

Anfragekörper

Name	Typ	Erforderlich	Was es ist
`inclusion_items`	`object[]`	Nein	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`	Nein	—
`summary`	`string`	Nein	—
`slug`	`string`	Nein	—
`field_values`	`object`	Nein	Plain `{key: value}` — the envelope is added by the engine.
`publish`	`boolean`	Nein	Validate against the stamped schema, require a package, recompute the price cache and go live — in one transaction.
`state`	`string<live, paused, archived>`	Nein	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…

Antwort

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

Fehler, die dieser Endpunkt zurückgeben kann

401 · 404 · 422

PATCH /v1/marketplace/listings/{listing_id}