Prodotti · Aggiungi file · multipart

Invia i file come multipart/form-data dopo aver creato upload_id, poi associali al prodotto. Il download richiede un token Bearer e il permesso per category; la risposta contiene i byte, senza indirizzo pubblico né password. Regola esplicita di accesso al file condiviso. new_purchases / recent_and_new / selected / all_purchasers.

PUT/api/v1/product-file-uploads/{upload_id}/content

Richiesta cURL

: "${SHOPENTLY_SHOP_URL:?}"

case "${SHOPENTLY_PRODUCT_FILE:?}" in *[!a-zA-Z0-9/._\ -]*) echo "Unsupported file path" >&2; exit 1;; esac

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 300 \
  --request PUT \
  --header "Authorization: Bearer ${SHOPENTLY_ACCESS_TOKEN:?}" \
  --form "file=@${SHOPENTLY_PRODUCT_FILE:?};filename=manual.pdf;type=application/pdf" \
  --url "${SHOPENTLY_SHOP_URL%/}"'/api/v1/product-file-uploads/00000000-0000-4000-8000-000000000001/content?category=digital'

Risposta

{
  "data": {
    "category": "digital",
    "expires_at": "2026-01-01T12:00:00Z",
    "filename": "manual.pdf",
    "id": "00000000-0000-4000-8000-000000000001",
    "product_id": "example",
    "received_bytes": 46,
    "sha256": "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd",
    "size_bytes": 46,
    "status": "ready"
  },
  "meta": {
    "request_id": "example"
  }
}

Permessi necessari

Autenticazione: Token di accesso
Disponibile dal piano: STANDARD
Permessi necessari

Permessi aggiuntivi per campi specifici

category=internal: Gestire i file del prodotto · File internicatalog.product_file:write_internal
category=customer_document: Gestire i file del prodotto · Documenti per il clientecatalog.product_file:write_customer_document
category=digital: Gestire i file del prodotto · Prodotti digitalicatalog.product_file:write_digital