Để gọi một API trong n8n, bạn thêm node HTTP Request, chọn method (GET, POST…), nhập URL endpoint, rồi cấu hình xác thực bằng credential thay vì dán API key vào URL. Cách nhanh nhất là dùng Import cURL: dán lệnh curl từ tài liệu API, n8n tự điền URL, header và body.
Bài này hướng dẫn gọi API bên ngoài từ workflow n8n, thuộc loạt hướng dẫn tạo workflow trên n8n. Nếu bạn cần API của chính n8n (để quản lý workflow từ bên ngoài), xem bài cách tạo API key trong n8n. Nội dung theo n8n 2.x, đối chiếu tài liệu node HTTP Request ngày 23/10/2026.
API là gì và vì sao n8n cần node HTTP Request?
API (Application Programming Interface) là tập quy tắc để hai phần mềm trao đổi dữ liệu: bên gọi gửi request tới một endpoint, bên kia trả response, thường ở dạng JSON. Ví dụ, ứng dụng bán hàng gọi API của cổng thanh toán để xử lý giao dịch, rồi gọi API của đơn vị vận chuyển để cập nhật trạng thái đơn.
n8n có hàng trăm node dựng sẵn cho Google Sheets, Slack, Telegram… nhưng không phải dịch vụ nào cũng có node. Node HTTP Request lấp chỗ trống đó: bạn gọi được mọi REST API, tự chọn URL, header, tham số và body theo tài liệu của dịch vụ.
- Kết nối dịch vụ chưa có node: hệ thống nội bộ, dịch vụ mới, endpoint mà node dựng sẵn chưa hỗ trợ.
- Chuyển dữ liệu tự động: lấy dữ liệu từ hệ thống A rồi gửi sang hệ thống B, ví dụ lấy đơn hàng rồi ghi vào Google Sheets.
- Tùy chỉnh request: chọn method, header, query, body đúng như API yêu cầu.
Các thành phần cấu hình của node HTTP Request
Node HTTP Request có sáu nhóm cấu hình: Method, URL, Authentication, Query Parameters, Headers và Body, cộng thêm Options và Settings. Ba nhóm đầu là bắt buộc với mọi API; các nhóm sau tùy tài liệu của dịch vụ bạn gọi.
Thành phần Ý nghĩa Ví dụ Method Hành động muốn làm với API GET lấy dữ liệu, POST tạo mới, PUT/PATCH cập nhật, DELETE xóa URL Địa chỉ endpoint, có thể dùng expression lấy từ node trước https://api.pexels.com/v1/searchAuthentication Cách chứng minh bạn được phép gọi API None, Predefined Credential Type, Generic Credential Type Query Parameters Tham số lọc gắn sau dấu ? của URL query=coffee, per_page=3Headers Thông tin gửi kèm request Content-Type: application/jsonBody Dữ liệu gửi đi với POST, PUT, PATCH JSON, form-data, file nhị phân Options Batching, Pagination, Timeout, Response format, Ignore SSL Issues Timeout tính bằng mili giây
URL có thể lấy giá trị từ node khác bằng expression. Cú pháp hiện hành là {{ $('Tên node').item.json.url }}; cách viết cũ $node["Tên node"].json["url"] vẫn chạy nhưng không còn được khuyên dùng (Reference previous nodes). Nếu chỉ cần dữ liệu của node ngay trước, viết gọn {{ $json.url }}.
Ignore SSL Issues chỉ dùng khi thử với máy chủ nội bộ có chứng chỉ tự ký. Với API thật trên Internet, tắt tùy chọn này để n8n kiểm chứng chỉ.
Cách nhanh nhất: Import cURL
Import cURL là nút ở đầu node HTTP Request cho phép dán lệnh curl từ tài liệu API; n8n tự điền method, URL, header, query và body. Đây là cách ít sai nhất khi tài liệu API có sẵn ví dụ curl.
- Mở node HTTP Request, bấm Import cURL.
- Dán lệnh curl, ví dụ lệnh tìm ảnh của Pexels bên dưới, rồi bấm Import.
- Kiểm lại các trường vừa được điền. Nếu lệnh có header chứa khóa (Authorization, X-API-Key), xóa header đó và chuyển khóa sang credential ở bước xác thực.
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ụ dưới đây tìm 3 ảnh miễn phí với từ khóa “coffee” từ Pexels API. Ảnh chụp làm trên n8n bản 1.x: nút Test step trong ảnh nay là Execute step, công tắc Inactive nay là nút Publish; các trường cấu hình giữ nguyên.
Bước 1: Lấy API key của Pexels
- Truy cập pexels.com/api, đăng nhập hoặc tạo tài khoản.
- Chọn Your API Key, điền thông tin theo yêu cầu để nhận khóa.

Bước 2: Thêm node HTTP Request vào workflow
Mở workflow, bấm + và tìm “http”, chọn HTTP Request. Bảng cấu hình node xuất hiện.


Bài chỉ hướng dẫn cấu hình node HTTP Request. Phía trước node này có thể là bất kỳ trigger hay node nào cung cấp dữ liệu:
Node đứng trước HTTP Request Khi nào dùng Webhook Khi dữ liệu đến từ hệ thống bên ngoài Schedule Trigger Khi muốn gọi API theo giờ Manual Trigger Khi chạy thử hoặc chạy thủ công Edit Fields (Set) Khi muốn truyền giá trị cố định, ví dụ từ khóa tìm kiếm Google Sheets, Airtable Khi dữ liệu đầu vào nằm sẵn trong bảng HTTP Request khác Khi cần gọi nhiều API nối tiếp
Bước 3: Lấy endpoint trong tài liệu Pexels
Trên trang Pexels API, chọn Documentation, mục Search for Photos. Endpoint tìm ảnh là:
GET https://api.pexels.com/v1/search

Trong node HTTP Request, chọn Method GET và nhập URL kèm tham số:
https://api.pexels.com/v1/search?query=coffee&per_page=3

URL này cần header xác thực, nên mở trực tiếp trên trình duyệt sẽ nhận lỗi 401. query và per_page là Query Parameters, xem Bước 5.
Bước 4: Gửi API key trong header
Pexels yêu cầu gửi khóa trong header Authorization.

Cách nhanh để thử: bật Send Headers, Name nhập Authorization, Value dán API key. Cách nên dùng khi chạy thật: Authentication chọn Generic Credential Type → Header Auth, tạo credential với Name Authorization và Value là khóa. Khóa được lưu mã hóa, không hiện trong node và không đi theo file khi export workflow.

Bước 5: Tùy chỉnh Query Parameters
Pexels hỗ trợ các tham số sau cho endpoint Search:
Tham số Ý nghĩa Ví dụ queryTừ khóa tìm kiếm (bắt buộc) coffee, nature, technology per_pageSố ảnh mỗi trang 1 đến 80 pageTrang số mấy 1, 2, 3… orientationHướng ảnh landscape, portrait, square sizeKích thước tối thiểu large, medium, small colorMàu chủ đạo red, blue, green…
Bạn có thể viết thẳng vào URL, ví dụ chỉ lấy ảnh nằm ngang:
https://api.pexels.com/v1/search?query=coffee&per_page=3&orientation=landscape
Hoặc bật Send Query Parameters và thêm từng cặp Name/Value, dễ đọc và dễ thay bằng expression hơn.
Bước 6: Bấm Execute step và đọc kết quả
Bấm Execute step để chạy riêng node. Panel Output hiển thị dữ liệu ở ba dạng Table, JSON, Schema. Chọn JSON để thấy photos, total_results, next_page; mở từng ảnh để lấy đường dẫn trong url hoặc src.


Bước 7: Dùng dữ liệu cho các bước sau
| Trường hợp | Node tiếp theo có thể dùng |
|---|---|
| Gửi ảnh qua Telegram | Telegram node |
| Gửi ảnh qua email | Gmail hoặc Send Email node |
| Lưu kết quả vào Airtable | Airtable node |
| Lưu link ảnh vào Google Sheet | Google Sheets node |
| Xử lý từng ảnh | Split Out tách mảng photos thành từng item |
Nên xác thực API trong HTTP Request bằng cách nào?
Node HTTP Request có hai kiểu xác thực: Predefined Credential Type dùng credential dựng sẵn của dịch vụ mà n8n đã hỗ trợ, và Generic Credential Type (Header Auth, Query Auth, Bearer, Basic, OAuth2, Digest) cho mọi API còn lại. Cả hai đều lưu khóa trong credential thay vì trong tham số node.

Mỗi credential có trường Allowed HTTP Request Domains: chỉ định tên miền được nhận khóa, ví dụ api.pexels.com, để khóa không bị gửi nhầm sang nơi khác khi ai đó sửa URL (Create and edit credentials). Kiến thức chung về credential có ở bài credential trong n8n là gì.
Credential và HTTP Request khác nhau thế nào?
Credential là thông tin đăng nhập được lưu mã hóa trong n8n; HTTP Request là node gửi request. Hai thứ không thay thế nhau: node dựng sẵn (Google Sheets, Telegram) chỉ cần credential, còn HTTP Request cần bạn tự điền URL, header, body và thường dùng thêm credential để xác thực.
Trường hợp Dùng HTTP Request Dùng credential Dịch vụ không có node sẵn trong n8n Có Nên dùng để giữ khóa Dịch vụ có node sẵn (Google Sheets, Telegram…) Không cần Cần Cần tùy chỉnh URL, header, body Cần Có thể dùng thêm Gọi API nội bộ hoặc REST API riêng Cần Có thể kèm theo Endpoint node sẵn chưa hỗ trợ Cần, chọn Predefined Credential Type để dùng lại credential của node Dùng lại credential đã tạo
Xử lý nhiều trang, giới hạn tốc độ và lỗi khi gọi API
Khi gọi API thật, ba tình huống hay gặp là dữ liệu chia nhiều trang, bị giới hạn tốc độ (lỗi 429) và lỗi tạm thời của máy chủ. Node HTTP Request có sẵn tùy chọn cho cả ba (HTTP Request common issues):
- Pagination (Options): tự gọi tiếp các trang. Chọn Update a Parameter in Each Request để tăng tham số
page, hoặc Response Contains Next URL để đi theo trường nhưnext_pagecủa Pexels. - Batching (Options): khi node nhận nhiều item, đặt Items per Batch và Batch Interval (ms) để gửi từng lô, tránh vượt giới hạn tốc độ.
- Retry On Fail (tab Settings): tự chạy lại khi lỗi, đặt Max Tries và Wait Between Tries; hợp với lỗi 429, 5xx.
- On Error (tab Settings): chọn Continue để workflow không dừng khi một item lỗi, rồi xử lý nhánh lỗi riêng.
Lỗi 401 thường do thiếu hoặc sai khóa, xem cách khắc phục lỗi 401 Unauthorized; bảng tra các mã 400, 403, 404, 429, 5xx có ở bài lỗi kết nối API thường gặp trong n8n.
Kết luận
Thêm API vào n8n gồm bốn việc: lấy endpoint trong tài liệu, cấu hình method và URL (hoặc Import cURL), lưu khóa trong credential, rồi chạy thử bằng Execute step. Khi API trả nhiều dữ liệu hoặc giới hạn tốc độ, bật Pagination, Batching và Retry On Fail trước khi Publish workflow.
Những câu hỏi thường gặp
Làm sao để biết dịch vụ có API hay không?
Phần lớn dịch vụ có trang tài liệu API chính thức. Tìm theo cú pháp: tên dịch vụ + API documentation. Nếu tài liệu có ví dụ curl, dùng Import cURL trong node HTTP Request.
Làm sao kiểm tra API đã gọi thành công hay chưa?
Bấm Execute step rồi xem panel Output. Có dữ liệu JSON là gọi thành công. Nếu báo lỗi, đọc mã lỗi: 401 kiểm lại khóa và header, 404 kiểm lại URL, 429 là vượt giới hạn tốc độ.
Một API có thể dùng cho nhiều node trong workflow không?
Có. Một node HTTP Request lấy dữ liệu, các node sau xử lý, lưu, gửi đi hoặc lặp lại. Credential của API cũng dùng lại được cho nhiều node và nhiều workflow.
Có cần biết lập trình để dùng API trong n8n không?
Không cần lập trình chuyên sâu. Bạn cần hiểu JSON, header, URL, method GET/POST và biết đọc tài liệu API của dịch vụ.
Có nên dán API key vào URL không?
Không nên. Khóa trong URL dễ lộ qua log và khi export workflow. Hãy dùng credential (Header Auth hoặc Query Auth) và điền Allowed HTTP Request Domains.
Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
