Gọi API trong n8n bằng HTTP Request: từ cURL đến workflow
Thiết lập endpoint, phương thức, credential, query và body; thực hành với Pexels rồi bổ sung phân trang, giới hạn tốc độ và xử lý lỗi.

HTTP Request là node để workflow n8n gọi một API bên ngoài. Bạn chọn phương thức, nhập endpoint và cấu hình xác thực theo tài liệu dịch vụ. Nếu có lệnh cURL mẫu, Import cURL giúp điền nhanh các trường; phần khóa bí mật vẫn nên chuyển vào credential trước khi vận hành.
Bài hướng dẫn chiều n8n gọi ra dịch vụ khác. Nếu muốn ứng dụng ngoài quản lý n8n, xem tạo API key n8n. Các cấu hình dưới đây được trình bày theo HTTP Request của n8n; ảnh giao diện cũ chỉ dùng để định vị chức năng.
API là gì và vì sao n8n cần node HTTP Request?
Một API quy định cách phần mềm gửi yêu cầu và nhận dữ liệu. Request đi tới một endpoint với method, tham số và thông tin xác thực; response có thể là JSON, file hoặc dạng dữ liệu khác. Chẳng hạn, hệ thống bán hàng gọi cổng thanh toán rồi gọi dịch vụ vận chuyển trong cùng một quy trình.
Các node dựng sẵn giúp kết nối nhanh dịch vụ quen thuộc. Khi chưa có node phù hợp, hoặc node hiện có thiếu một endpoint, HTTP Request cho bạn tự cấu hình lời gọi REST theo đúng tài liệu API.
- Mở rộng kết nối: gọi hệ thống nội bộ, dịch vụ mới hoặc endpoint chưa được node dựng sẵn hỗ trợ.
- Luân chuyển dữ liệu: lấy thông tin từ một ứng dụng, biến đổi rồi gửi sang ứng dụng khác.
- Điều khiển request: tự chọn method, header, query và body theo bài toán.
Các thành phần cấu hình của node HTTP Request
| Trường | Dùng để | Ví dụ |
|---|---|---|
| Method | Chọn thao tác HTTP | GET đọc; POST tạo; PUT/PATCH cập nhật; DELETE xóa |
| URL | Địa chỉ endpoint | Https://api.pexels.com/v1/search |
| Authentication | Chọn cơ chế xác thực hoặc None | Predefined Credential Type; Generic Credential Type |
| Query Parameters | Gửi tham số trên query string | Query=coffee; per_page=3 |
| Headers | Gửi thông tin đi kèm | Content-Type: application/json |
| Body | Gửi nội dung với method cần body | JSON; form-data; binary file |
| Options / Settings | Điều khiển quá trình gọi | Pagination; Batching; Timeout; Retry On Fail |
URL và tham số có thể dùng expression lấy dữ liệu từ bước trước. Ví dụ {{ $json.url }} đọc trường url của item hiện tại; {{ $('Tên node').item.json.url }} tham chiếu một node cụ thể. Kiểm tra preview của expression để tránh gửi địa chỉ rỗng hoặc nhầm item.
Chỉ dùng Ignore SSL Issues khi chẩn đoán một hệ thống thử nghiệm được kiểm soát. Với API trên Internet, giữ việc kiểm tra chứng chỉ và sửa lỗi TLS từ gốc.
Cách nhanh nhất: Import cURL
Nếu tài liệu cung cấp cURL, bạn có thể nhập trực tiếp vào node để giảm lỗi gõ lại endpoint và tham số. Việc import không thay thế bước kiểm tra bảo mật hoặc kiểm tra request.
- Mở node và chọn Import cURL.
- Dán ví dụ của API rồi thực hiện import.
- Đối chiếu method, URL, body và header sau khi nhập. Xóa khóa khỏi header tĩnh và chuyển sang credential trước khi lưu workflow dùng thật.
curl -H "Authorization: YOUR_PEXELS_API_KEY" \
"https://api.pexels.com/v1/search?query=coffee&per_page=3"Ví dụ: gọi Pexels API để tìm ảnh bằng HTTP Request
Ví dụ này lấy 3 ảnh cho từ khóa “coffee”. Ảnh minh họa dùng n8n 1.x nên có nút Test step; trên các bản mới, hãy tìm Execute step và thao tác Publish tương ứng.
Bước 1: Lấy API key của Pexels
- Mở Pexels API và đăng nhập tài khoản.
- Vào Your API Key, hoàn thành thông tin đăng ký API theo yêu cầu rồi lưu khóa ở nơi kín.

Bước 2: Thêm node HTTP Request vào workflow
Trong workflow, bấm dấu cộng, tìm HTTP Request và thêm node. Bạn sẽ cấu hình các trường ở bảng Parameters.


| Bước trước HTTP Request | Tình huống phù hợp |
|---|---|
| Manual Trigger | Chạy thử có kiểm soát |
| Schedule Trigger | Gọi theo lịch |
| Webhook | Nhận yêu cầu từ ứng dụng khác |
| Edit Fields (Set) | Chuẩn bị từ khóa hoặc giá trị cố định |
| Google Sheets / Airtable | Đọc dữ liệu đầu vào từ bảng |
| HTTP Request khác | Nối tiếp nhiều lời gọi API |
Bước 3: Lấy endpoint trong tài liệu Pexels
Trong tài liệu Pexels, mở phần Search for Photos để xác nhận đường dẫn và method hiện hành:
GET https://api.pexels.com/v1/search
Đặt Method = GET, sau đó nhập endpoint. Có thể gắn query ngay trong URL như ví dụ:
https://api.pexels.com/v1/search?query=coffee&per_page=3
Đây là endpoint cần xác thực. Mở URL bằng trình duyệt mà không có header phù hợp không phải phép thử đầy đủ. query là từ khóa; per_page điều khiển số ảnh trong một trang.
Bước 4: Gửi API key trong header
Với Pexels, khóa nằm trong header Authorization. Không tự thêm tiền tố Bearer nếu tài liệu của endpoint không yêu cầu.

Để chạy thật, chọn Authentication → Generic Credential Type → Header Auth, tạo credential có Name là Authorization và Value là khóa Pexels. Cách nhập trực tiếp ở Send Headers chỉ nên dùng trong bước thử có kiểm soát: giá trị đặt ngay trong node có thể bị xuất cùng workflow hoặc lộ khi chia sẻ cấu hình.

Bước 5: Tùy chỉnh Query Parameters
| Tham số | Ý nghĩa | Giá trị ví dụ |
|---|---|---|
| Query | Từ khóa bắt buộc | Coffee |
| Per_page | Số kết quả mỗi trang | 3; tối đa theo tài liệu Pexels |
| Page | Trang cần lấy | 1, 2, 3 |
| Orientation | Hướng ảnh | Landscape; portrait; square |
| Size | Kích thước tối thiểu | Large; medium; small |
| Color | Lọc màu | Red; blue; mã màu nếu API hỗ trợ |
Ví dụ dưới đây giới hạn ảnh theo hướng nằm ngang:
https://api.pexels.com/v1/search?query=coffee&per_page=3&orientation=landscapeĐể dễ bảo trì hơn, bật Send Query Parameters và điền từng Name/Value. Khi đó bạn có thể thay từ khóa bằng expression mà không nối chuỗi URL thủ công.
Bước 6: Bấm Execute step và đọc kết quả
Chọn Execute step rồi xem Output. Dạng JSON giúp quan sát photos, total_results và đường dẫn trang tiếp theo. Trong từng phần tử ảnh, url trỏ tới trang ảnh còn src chứa các kích thước tài nguyên.


Bước 7: Chuyển dữ liệu sang node tiếp theo
Chọn trường cần dùng từ Output và ánh xạ vào node sau, chẳng hạn lưu URL ảnh vào bảng hoặc gửi qua một kênh thông báo. Nếu response chứa mảng, kiểm tra số item mà node sau nhận để xử lý đúng từng ảnh thay vì chỉ phần tử đầu.
| Việc muốn làm | Node có thể nối tiếp |
|---|---|
| Gửi ảnh qua Telegram | Telegram |
| Gửi ảnh qua email | Gmail hoặc Send Email |
| Lưu kết quả vào bảng dữ liệu | Airtable |
| Lưu đường dẫn ảnh | Google Sheets |
| Xử lý từng phần tử photos | Split Out để tách mảng thành item |
Nên xác thực API trong HTTP Request bằng cách nào?
Authentication có hai hướng: Predefined Credential Type tái sử dụng credential của một dịch vụ n8n đã hỗ trợ; Generic Credential Type dùng các cơ chế chung như Header Auth, Query Auth, Basic hoặc OAuth2. Chọn theo tài liệu API, không theo tên gọi của khóa.

Nếu credential hỗ trợ Allowed HTTP Request Domains, giới hạn về đúng tên miền nhận khóa, chẳng hạn api.pexels.com. Cấu hình này giảm nguy cơ gửi bí mật sang host khác khi URL bị sửa. Xem thêm cách bảo mật credential.
Credential và HTTP Request khác nhau thế nào?
| Tình huống | HTTP Request | Credential |
|---|---|---|
| Dịch vụ chưa có node | Tự nhập endpoint và request | Dùng để giữ khóa nếu cần xác thực |
| Node dựng sẵn đủ chức năng | Có thể không cần HTTP Request | Chọn credential của dịch vụ |
| Cần endpoint đặc biệt | Dùng HTTP Request | Có thể tái sử dụng Predefined Credential Type |
| API nội bộ | Cấu hình theo tài liệu hệ thống | Tùy cơ chế xác thực |
Xử lý nhiều trang, giới hạn tốc độ và lỗi khi gọi API
Khi chuyển từ request thử sang workflow chạy thường xuyên, hãy tính cả phân trang, số item đầu vào và các sự cố tạm thời. Đây là các cơ chế thường dùng:
- Pagination: tăng tham số page theo từng lần gọi hoặc đi theo URL trang tiếp mà response cung cấp.
- Batching: chia item thành lô và đặt khoảng nghỉ bằng mili giây để phù hợp rate limit.
- Retry On Fail: thử lại có giới hạn khi gặp lỗi tạm thời, chẳng hạn 429, 5xx hoặc timeout. Với request tạo mới, phải xét nguy cơ ghi trùng.
- On Error: dùng đầu ra lỗi để ghi log, cảnh báo hoặc rẽ nhánh; đừng tiếp tục âm thầm như thể request đã thành công.
Khi gặp 401, rà khóa và cách đặt header trước. 404 thường cần kiểm URL hoặc ID tài nguyên; 429 cần giảm tốc độ hoặc xem quota. Bảng chẩn đoán đầy đủ nằm ở lỗi API thường gặp trong n8n.
Kết luận
Một cấu hình dễ bảo trì bắt đầu từ tài liệu endpoint, thử request nhỏ, chuyển bí mật vào credential rồi kiểm tra Output. Chỉ Publish sau khi đã xử lý phân trang, quota và các nhánh thất bại có thể dự đoán.
Những câu hỏi thường gặp
Làm sao để biết dịch vụ có API hay không?
Tìm trang tài liệu developer hoặc API của chính dịch vụ. Chỉ dựa vào URL hay kết quả trên giao diện không đủ để kết luận có API công khai. Khi có cURL mẫu, bạn có thể dùng Import cURL để thử.
Làm sao kiểm tra API đã gọi thành công hay chưa?
Xem mã trạng thái và nội dung response trong Output. JSON hợp lệ chưa chắc đồng nghĩa nghiệp vụ thành công, nên kiểm cả trường báo lỗi và dữ liệu mong đợi của API.
Một API có thể dùng cho nhiều node trong workflow không?
Được. Nhiều node có thể gọi cùng dịch vụ và dùng lại một credential phù hợp. Dữ liệu trả về cũng có thể chuyển tới các node xử lý, lưu trữ hoặc gửi thông báo.
Có cần biết lập trình để dùng API trong n8n không?
Bạn không cần viết một ứng dụng hoàn chỉnh, nhưng nên hiểu method, URL, header, JSON và cách đọc tài liệu endpoint. Với expression hoặc dữ liệu phức tạp, một ít kiến thức lập trình sẽ hữu ích.
Có nên dán API key vào URL không?
Tránh để khóa thành chuỗi tĩnh trong URL vì URL dễ xuất hiện trong log và cấu hình chia sẻ. Dùng credential với vị trí khóa đúng theo tài liệu; nếu dịch vụ bắt buộc query auth, vẫn lưu giá trị qua credential thay vì gõ thẳng vào URL.