marketplace
POST /v1/marketplace/listings/{listing_id}/images
Upload one image to a listing.
Autentizace
Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X POST https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/images \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
The bytes are decoded to decide the format — the declared Content-Type and the filename are both caller-chosen — checked against the listing type's policy, stripped of EXIF and re-encoded with orientation applied, and only then stored. A rejected upload leaves nothing behind: no object, no row. ⛔⛔ EXIF is removed before storage, not on the way out. A phone photo of a house for sale carries the GPS coordinates of the house. ⛔ An image is content, so adding one to a live third-party listing takes it off sale and back into the review queue (docs/78 §5). A 422 carries code and params in details — TOO_SMALL with the actual and required dimensions, for example — so the surface renders the sentence in the seller's own language rather than the engine hardcoding English (CLAUDE.md §2.19).
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
listing_id (path) | string | Ano | — |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
id | string | Ano | — |
url | string | Ne | 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… |
srcset | string | Ne | 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 | Ano | 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 | Ano | Pixel height after orientation is applied. |
alt | string | Ne | — |
is_cover | boolean | Ano | — |
position | integer | Ano | — |
Chyby, které může tento koncový bod vrátit
401 · 404 · 422