跳至内容
ShopentlyLearn
简体中文

产品 · 商品文件

创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。 共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers.

GET/api/v1/products/{product_id}/files

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/products/example/files?category=digital' \
  --header 'Authorization: Bearer EXAMPLE_ACCESS_TOKEN'

响应 

{
  "data": {
    "files": [
      {
        "category": "digital",
        "created_at": "2026-01-01T12:00:00Z",
        "current_version_id": "00000000-0000-4000-8000-000000000001",
        "file_id": "00000000-0000-4000-8000-000000000001",
        "filename": "manual.pdf",
        "id": "00000000-0000-4000-8000-000000000001",
        "label": "Manual",
        "mime_type": "application/pdf",
        "sha256": "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd",
        "size_bytes": 46,
        "state": "active",
        "version_number": 1
      }
    ],
    "product_version": 2
  },
  "meta": {
    "pagination": {
      "has_more": false,
      "limit": 50,
      "next_cursor": null
    },
    "request_id": "example"
  }
}

所需权限

身份验证
访问令牌
最低套餐
STANDARD
所需权限
特定字段所需的附加权限
  • category=internal: 查看商品文件 · 内部文件catalog.product_file:read_internal
  • category=customer_document: 查看商品文件 · 客户文档catalog.product_file:read_customer_document
  • category=digital: 查看商品文件 · 数字商品catalog.product_file:read_digital