close

Cách thêm API vào n8n bằng node HTTP Request (hướng dẫn chi tiết)

Tác giả: Đông Tùng Ngày đăng: 28/04/2025 Chuyên mục: n8n
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

Để 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ĩaVí dụ
MethodHành động muốn làm với APIGET 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ướchttps://api.pexels.com/v1/search
AuthenticationCách chứng minh bạn được phép gọi APINone, Predefined Credential Type, Generic Credential Type
Query ParametersTham số lọc gắn sau dấu ? của URLquery=coffee, per_page=3
HeadersThông tin gửi kèm requestContent-Type: application/json
BodyDữ liệu gửi đi với POST, PUT, PATCHJSON, form-data, file nhị phân
OptionsBatching, Pagination, Timeout, Response format, Ignore SSL IssuesTimeout tính bằng mili giây
Các trường chính của node HTTP Request (docs.n8n.io, truy cập 23/10/2026)

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.

  1. Mở node HTTP Request, bấm Import cURL.
  2. Dán lệnh curl, ví dụ lệnh tìm ảnh của Pexels bên dưới, rồi bấm Import.
  3. 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.
Trang Pexels API với nút Your API Key và Documentation để lấy khóa API miễn phí

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.

Tìm từ khóa http trong bảng chọn node của n8n và chọn node HTTP Request
Bảng cấu hình node HTTP Request trong n8n: Import cURL, Method GET, URL, Authentication None, Send Query Parameters, Send Headers, Send Body, Options

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 RequestKhi nào dùng
WebhookKhi dữ liệu đến từ hệ thống bên ngoài
Schedule TriggerKhi muốn gọi API theo giờ
Manual TriggerKhi 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, AirtableKhi dữ liệu đầu vào nằm sẵn trong bảng
HTTP Request khácKhi 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
Tài liệu Pexels API mục Search for Photos với endpoint GET https://api.pexels.com/v1/search và tham số query bắt buộc

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
Node HTTP Request trong n8n với Method GET và URL 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.

Tài liệu Pexels: mọi request cần gửi API key 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.

Node HTTP Request bật Send Headers, Header Parameters Name là Authorization, Value là API key Pexels đã được che

Bước 5: Tùy chỉnh Query Parameters

Pexels hỗ trợ các tham số sau cho endpoint Search:

Tham sốÝ nghĩaVí dụ
queryTừ khóa tìm kiếm (bắt buộc)coffee, nature, technology
per_pageSố ảnh mỗi trang1 đến 80
pageTrang số mấy1, 2, 3…
orientationHướng ảnhlandscape, portrait, square
sizeKích thước tối thiểularge, medium, small
colorMàu chủ đạored, blue, green…
Tham số của Pexels Search for Photos (theo tài liệu Pexels)

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.

Panel OUTPUT của node HTTP Request dạng JSON: page 1, per_page 3, mảng photos 3 phần tử, total_results và next_page
Chi tiết một ảnh trong kết quả Pexels API: id, width, height, url, photographer, avg_color và các đường dẫn src

Bước 7: Dùng dữ liệu cho các bước sau

Trường hợpNode tiếp theo có thể dùng
Gửi ảnh qua TelegramTelegram node
Gửi ảnh qua emailGmail hoặc Send Email node
Lưu kết quả vào AirtableAirtable node
Lưu link ảnh vào Google SheetGoogle Sheets node
Xử lý từng ảnhSplit 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.

Cây quyết định chọn kiểu xác thực cho node HTTP Request trong n8n: dịch vụ đã có credential thì chọn Predefined Credential Type, chưa có thì chọn Generic Credential Type như Header Auth, Query Auth, Bearer, Basic, OAuth2; điền Allowed HTTP Request Domains

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ợpDùng HTTP RequestDùng credential
Dịch vụ không có node sẵn trong n8nCóNên dùng để giữ khóa
Dịch vụ có node sẵn (Google Sheets, Telegram…)Không cầnCần
Cần tùy chỉnh URL, header, bodyCầnCó thể dùng thêm
Gọi API nội bộ hoặc REST API riêngCầnCó 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 nodeDù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_page củ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.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan

Xem nhiều