marketplace
POST /v1/marketplace/listings/{listing_id}/images
Upload one image to a listing.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/images \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
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).
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
listing_id (path) | string | Да | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
id | string | Да | — |
url | string | Не | 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 | Не | 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 | Да | 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 | Да | Pixel height after orientation is applied. |
alt | string | Не | — |
is_cover | boolean | Да | — |
position | integer | Да | — |
Грешке које ова крајња тачка може вратити
401 · 404 · 422