marketplace

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

Set the alt text, the gallery position, or make this the cover.

Autentificare

Trimiteți o cheie API ca token de tip bearer. Acest punct final nu specifică o permisiune anume în specificație, așa că acordați cheii cele mai puține drepturi necesare și verificați răspunsul în loc să faceți presupuneri.

Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.

Încearcă

Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.

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

Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API

Detalii

Promoting a cover demotes the incumbent in the same write — there is a partial unique constraint allowing exactly one cover per listing, so doing it in two steps would fail.

Parametri

Nume	Tip	Obligatoriu	Ce este
`listing_id (path)`	`string`	Da	—
`image_id (path)`	`string`	Da	—

Corp cerere

Nume	Tip	Obligatoriu	Ce este
`alt`	`string`	Nu	—
`position`	`integer`	Nu	—
`is_cover`	`boolean`	Nu	Only `true` is meaningful — a listing always has exactly one cover.

Răspuns

Nume	Tip	Obligatoriu	Ce este
`id`	`string`	Da	—
`url`	`string`	Nu	The original. ⛔ `null` when no public delivery origin is configured, rather than a guessed URL — an R2 bucket is not public by default, and a card with a broken image is worse t…
`srcset`	`string`	Nu	Width candidates through Cloudflare image resizing with `format=auto`, so a phone downloads a phone-sized AVIF/WebP and an old browser still gets something it can decode. Empty…
`width`	`integer`	Da	Pixel width AFTER orientation is applied. Required in the markup to reserve space — an `<img>` without it is the largest single source of layout shift.
`height`	`integer`	Da	Pixel height after orientation is applied.
`alt`	`string`	Nu	—
`is_cover`	`boolean`	Da	—
`position`	`integer`	Da	—

Erori pe care le poate returna acest punct final

401 · 404

PATCH /v1/marketplace/listings/{listing_id}/images/{image_id}