marketplace
POST /v1/marketplace/listings/{listing_id}/images
Upload one image to a listing.
Автентифікація
Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.
Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.
Спробувати
Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.
curl -X POST https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/images \
-H "Authorization: Bearer zdk_live_…"Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого 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