Phan Đông GiangPhan Đông Giang
Tất cả bài viết

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.

Gọi API trong n8n bằng HTTP Request: từ cURL đến workflow

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ườngDùng đểVí dụ
MethodChọn thao tác HTTPGET đọc; POST tạo; PUT/PATCH cập nhật; DELETE xóa
URLĐịa chỉ endpointHttps://api.pexels.com/v1/search
AuthenticationChọn cơ chế xác thực hoặc NonePredefined Credential Type; Generic Credential Type
Query ParametersGửi tham số trên query stringQuery=coffee; per_page=3
HeadersGửi thông tin đi kèmContent-Type: application/json
BodyGửi nội dung với method cần bodyJSON; form-data; binary file
Options / SettingsĐiều khiển quá trình gọiPagination; 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.
Sao chép code
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.
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

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.

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ước trước HTTP RequestTình huống phù hợp
Manual TriggerChạy thử có kiểm soát
Schedule TriggerGọi theo lịch
WebhookNhậ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ácNố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:

Sao chép code
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

Đặt Method = GET, sau đó nhập endpoint. Có thể gắn query ngay trong URL như ví dụ:

Sao chép code
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

Đâ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.

Tài liệu Pexels: mọi request cần gửi API key trong header Authorization

Để 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.

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

Tham sốÝ nghĩaGiá trị ví dụ
QueryTừ khóa bắt buộcCoffee
Per_pageSố kết quả mỗi trang3; tối đa theo tài liệu Pexels
PageTrang cần lấy1, 2, 3
OrientationHướng ảnhLandscape; portrait; square
SizeKích thước tối thiểuLarge; medium; small
ColorLọc màuRed; 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:

Sao chép code
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.

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: 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àmNode có thể nối tiếp
Gửi ảnh qua TelegramTelegram
Gửi ảnh qua emailGmail hoặc Send Email
Lưu kết quả vào bảng dữ liệuAirtable
Lưu đường dẫn ảnhGoogle Sheets
Xử lý từng phần tử photosSplit 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.

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
Minh họa được biên tập lại cho PHAN ĐÔNG GIANG; giao diện thực tế có thể khác.

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ốngHTTP RequestCredential
Dịch vụ chưa có nodeTự nhập endpoint và requestDùng để giữ khóa nếu cần xác thực
Node dựng sẵn đủ chức năngCó thể không cần HTTP RequestChọn credential của dịch vụ
Cần endpoint đặc biệtDùng HTTP RequestCó thể tái sử dụng Predefined Credential Type
API nội bộCấu hình theo tài liệu hệ thốngTù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.

Bộ SKILLS EDIT VIDEOBạn quay. AI edit tự động.Ủng hộ mình 1 ly cafe
Video thật. Thành quả từ bộ Skills.
Trọn bộ 8 Skills · Mua một lần, dùng trọn đời

Để AI edit.
Dành thời gian cho điều quan trọng.

Thời gian edit mỗi video
3–4 giờ5–10 phút
Ưu đãi có hạn2.199.000đXem giá hiện tạiTrọn bộ 8 Skills & video hướng dẫn

Tiết kiệm 800.000đ · Mua một lần, dùng trọn đời.

Sở hữu bộ 8 SKILLS ngay!

Nhận bộ Skills và video hướng dẫn qua email.