TracePass
Inizia ora
Prodotti

Caricare un'immagine del prodotto

Carica un singolo file immagine (multipart/form-data, nome del campo `file`) e lo aggiunge in coda all'array `imageUrls` del prodotto. Usatelo quando non avete pronto un URL del CDN — l'immagine finisce nel nostro bucket R2 e l'URL pubblico viene restituito nella risposta.

POST/api/v1/products/{id}/images
Scarica OpenAPI 3.1
POST/api/v1/products/{id}/images

Caricare un'immagine del prodotto

Carica un singolo file immagine (multipart/form-data, nome del campo `file`) e lo aggiunge in coda all'array `imageUrls` del prodotto. Usatelo quando non avete pronto un URL del CDN — l'immagine finisce nel nostro bucket R2 e l'URL pubblico viene restituito nella risposta.

Solo PNG / JPG / WebP, max 5 MB per file, max 20 immagini per prodotto. **Nessun supporto per Idempotency-Key** — i corpi multipart non sono calcolabili in hash in modo sicuro. Il client dovrebbe verificare l'esistenza + saltare in caso di nuovo tentativo. Il corrispondente `DELETE /api/v1/products/{id}/images/{index}` rimuove una singola immagine tramite indice su base zero.

Parametri di percorso

  • idobbligatorio

    ObjectId

    ID del prodotto.

Header

  • Authorizationobbligatorio

    string

    `Bearer <api-key>`.

  • Content-Typeobbligatorio

    string

    `multipart/form-data` con il parametro boundary impostato dal vostro client HTTP.

Campi del corpo

  • fileobbligatorio

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

    Byte dell'immagine inviati come campo del modulo `file`.

Richiesta

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

Risposta

{
  "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"
  ]
}

Endpoint correlati