Description

!Banner image

n8n Multiple Upload Request Node

Một n8n community node chuyên dụng để upload nhiều file nhị phân (binary files) động với khả năng lọc theo pattern và hỗ trợ authentication.

Tiếng Việt | English

Tính năng chính

✨ Upload nhiều file động – Tự động upload tất cả các file nhị phân từ input hoặc lọc theo pattern

🎯 Lọc file theo pattern – Hỗ trợ wildcard patterns (*, ?) để chọn lọc file cần upload

🔐 Authentication linh hoạt – Hỗ trợ Bearer Token, Custom Header, hoặc không authentication

🔧 Tùy chỉnh linh hoạt – Thêm form fields, query parameters, custom headers

📡 HTTP Methods – Hỗ trợ POST, PUT, PATCH requests

⚡ Xử lý lỗi mạnh mẽ – Continue on fail, timeout configuration, SSL validation options

Cài đặt

npm install n8n-nodes-multiple-upload-request

Cách sử dụng

1. Thêm node vào workflow

Tìm kiếm “Multiple Upload Request” trong danh sách nodes của n8n.

2. Cấu hình cơ bản

Authentication: Chọn phương thức xác thực

• None: Không cần xác thực
• Bearer Token: Sử dụng Bearer token (cần credential)
• Custom Header: Sử dụng custom header authentication (cần credential)

Request Method: Chọn HTTP method (POST/PUT/PATCH)

URL: URL endpoint để upload file

File Pattern: Pattern để lọc file (mặc định: * – tất cả file)

• * – Upload tất cả file
• *.jpg – Chỉ upload file .jpg
• image* – Upload file bắt đầu bằng “image“
• file?.pdf – Upload file như file1.pdf, file_a.pdf

Binary Property Name: Tên property chứa binary data (mặc định: data)

• Có thể nhập nhiều property, phân cách bằng dấu phẩy: data, file, attachment

3. Tùy chọn nâng cao

#### Additional Form Fields
Thêm các field text vào form data cùng với file upload.

#### Query Parameters
Thêm query parameters vào URL request.

#### Additional Headers
Thêm custom headers vào request (ví dụ: Content-Type, X-Custom-Header).

#### Timeout
Cấu hình thời gian timeout cho request (mặc định: 10000ms).

#### Ignore SSL Issues
Bỏ qua lỗi SSL certificate validation (hữu ích cho môi trường development).

Ví dụ sử dụng

Ví dụ 1: Upload tất cả ảnh JPG

File Pattern: *.jpg
Binary Property Name: data

Ví dụ 2: Upload nhiều file từ nhiều property

File Pattern: *
Binary Property Name: image, document, attachment

Ví dụ 3: Upload với Bearer authentication

Authentication: Bearer Token
Request Method: POST
URL: https://api.example.com/upload
File Pattern: *

Ví dụ 4: Upload với form fields bổ sung

Additional Form Fields:
  - userId: 12345
  - category: documents
  - tags: important,urgent

Pattern Matching

Node hỗ trợ wildcard patterns để lọc file:

• * – Khớp với bất kỳ ký tự nào (0 hoặc nhiều)
• ? – Khớp với đúng 1 ký tự
• Pattern không phân biệt hoa thường

Ví dụ patterns:

• *.pdf → Tất cả file PDF
• report*.xlsx → Các file Excel bắt đầu bằng “report“
• image?.png → image1.png, imagea.png, imagex.png
• 2024-??-*.jpg → 2024-01-photo.jpg, 2024-12-image.jpg

Credentials

Bearer Token Authentication

Để sử dụng Bearer Token authentication:

1. Tạo credential mới loại Bearer Token Auth
2. Nhập Bearer token của bạn
3. Chọn credential này trong node

Custom Header Authentication

Để sử dụng Custom Header authentication:

1. Tạo credential mới loại Custom Header Auth
2. Nhập Header Name (ví dụ: X-API-Key, Authorization)
3. Nhập Header Value (giá trị của header)
4. Chọn credential này trong node

API Response

Node trả về response JSON từ server:

{
  "success": true,
  "message": "Files uploaded successfully",
  "files": [
    {
      "filename": "image1.jpg",
      "size": 102400,
      "url": "https://example.com/uploads/image1.jpg"
    }
  ]
}

Xử lý lỗi

Node hỗ trợ Continue on Fail mode:

• Khi bật: Lỗi sẽ được trả về dưới dạng JSON và workflow tiếp tục
• Khi tắt: Lỗi sẽ dừng workflow

Development

Yêu cầu

• Node.js (v22 trở lên) và npm
• git

Clone và cài đặt

git clone https://github.com/OrgGem/n8n-nodes-multiple-upload-request.git
cd n8n-nodes-multiple-upload-request
npm install

Development mode

Chạy n8n với node được load và hot reload enabled:

npm run dev

Build

Build node cho production:

npm run build

Lint và format

npm run lint
npm run lint:fix

Testing

Xem LICENSE.md file for details.

Support

• Documentation: n8n docs
• Community: n8n community forum
• Issues: GitHub Issues

Changelog

Xem CHANGELOG.md để biết lịch sử thay đổi.

Author

n8n Community

• Email: community@n8n.io

Acknowledgments

• n8n team for the excellent workflow automation platform
• n8n community for inspiration and support

—

Made with ❤️ for the n8n community