TracePass
Започнете
Продукти

Качване на изображение на продукт

Качване на единичен файл с изображение (multipart/form-data, име на полето `file`) и добавянето му към масива `imageUrls` на продукта. Използвайте това, когато нямате готов CDN URL — изображението попада в R2 bucket-а ни и публичният URL се връща в отговора.

POST/api/v1/products/{id}/images
Изтегли OpenAPI 3.1
POST/api/v1/products/{id}/images

Качване на изображение на продукт

Качване на единичен файл с изображение (multipart/form-data, име на полето `file`) и добавянето му към масива `imageUrls` на продукта. Използвайте това, когато нямате готов CDN URL — изображението попада в R2 bucket-а ни и публичният URL се връща в отговора.

Само PNG / JPG / WebP, макс. 5 MB на файл, макс. 20 изображения на продукт. **Не поддържа Idempotency-Key** — multipart телата не се хешират безопасно. Клиентът трябва да проверява за съществуване + да пропуска при retry. Съответстващият `DELETE /api/v1/products/{id}/images/{index}` премахва едно изображение по zero-based индекс.

Параметри в пътя

  • idзадължително

    ObjectId

    ID на продукта.

Хедъри

  • Authorizationзадължително

    string

    `Bearer <api-key>`.

  • Content-Typeзадължително

    string

    `multipart/form-data` с boundary, зададен от вашия HTTP клиент.

Полета в тялото

  • fileзадължително

    binary (PNG / JPG / WebP, ≤ 5 MB)

    Байтове на изображението, изпратени като form поле `file`.

Заявка

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/images \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -F "file=@./battery-hero.jpg"

Отговор

{
  "imageUrl": "https://r2.tracepass.eu/<companyId>/products/<id>/images/<imageId>.jpg",
  "imageUrls": [
    "https://existing-image-1.jpg",
    "https://r2.tracepass.eu/<companyId>/products/<id>/images/<imageId>.jpg"
  ]
}

Свързани endpoints