Productos · Estado · upload_id

Envía los archivos como multipart/form-data después de crear upload_id y asígnalos a un producto. La descarga requiere un token Bearer y permiso para category; la respuesta contiene los bytes, sin dirección pública ni contraseña. Regla explícita de acceso al archivo compartido. new_purchases / recent_and_new / selected / all_purchasers.

GET/api/v1/product-file-uploads/{upload_id}

Solicitud cURL

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 30 \
  --request GET \
  --url 'https://shop.onshopently.com/api/v1/product-file-uploads/00000000-0000-4000-8000-000000000001?category=digital' \
  --header 'Authorization: Bearer EXAMPLE_ACCESS_TOKEN'

Respuesta

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

Permisos necesarios

Autenticación: Token de acceso
Disponible desde: STANDARD
Permisos necesarios

Permisos adicionales para determinados campos

category=internal: Ver archivos del producto · Archivos internoscatalog.product_file:read_internal
category=customer_document: Ver archivos del producto · Documentos para clientescatalog.product_file:read_customer_document
category=digital: Ver archivos del producto · Productos digitalescatalog.product_file:read_digital