Kiểm tra Route

Sau khi tạo Route, bạn gửi thử request tới Gateway URL của API Gateway để xác nhận request đi qua API Gateway và được Route chuyển tới backend. Trang này dùng Postman làm ví dụ, nhưng bạn có thể dùng bất kỳ công cụ gửi HTTP request nào, ví dụ curl.

Cấu hình dùng trong ví dụ:

Thành phần	Giá trị
API Gateway	anhdtp-2109, Gateway URL là https://YOUR_GATEWAY_URL
Route	route-echo: Protocols HTTPS, HTTP Methods GET, Paths /echo
Upstream	upstream-echo: Target Address = backend address, Port 443

cảnh báo

API Gateway phải ở trạng thái Active và Route phải ở trạng thái Published thì mới nhận request. Xem Xem thông tin API Gateway.

Bước 1Sao chép Gateway URL của API Gateway

1 / 6

Nhấn vào ảnh để phóng to.

Kiểm tra Route

So sánh kết quả trước và sau khi có Route sẽ thấy rõ vai trò của Route. Để kiểm tra Route, bạn thực hiện các bước sau:

1. Chọn API Gateway → Gateway ở menu bên trái. Tại dòng API Gateway chứa Route, nhấn biểu tượng sao chép ở cột Gateway URL.

2. Gửi request GET tới Gateway URL kèm path cần kiểm tra, ví dụ https://YOUR_GATEWAY_URL/echo. Khi API Gateway chưa có Route nào khớp path /echo, kết quả là 404 Not Found với nội dung {"error_msg":"404 Route Not Found"}. Nghĩa là request đã tới API Gateway, nhưng API Gateway chưa biết chuyển request đi đâu.

3. Tạo Route khớp request, xem Tạo Route. Trong ví dụ, Route route-echo nhận GET tới path /echo qua HTTPS.

Tại tab Upstream (nhãn REF) của Route, kiểm tra backend address mà Route chuyển request tới.

4. Gửi lại đúng request ở Bước 2. Kết quả là 200 OK với nội dung do backend trả về. Trong response có header X-Forwarded-Host là domain của Gateway URL và header X-Real-IP.

5. Gọi trực tiếp backend address để đối chiếu (tùy chọn). Kết quả cũng là 200 OK nhưng không có header X-Forwarded-Host và X-Real-IP. Hai header này do API Gateway thêm vào, nên request ở Bước 4 đã đi qua API Gateway.

Đọc kết quả

Kết quả	Ý nghĩa
404 Not Found, nội dung {"error_msg":"404 Route Not Found"}	Request đã tới API Gateway nhưng không có Route nào khớp protocol, method và path của request.
200 OK, response có header X-Forwarded-Host là domain của Gateway URL	Request đi qua API Gateway, khớp Route và được chuyển tới backend.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách xử lý
Vẫn nhận 404 Route Not Found dù đã tạo Route	Protocol, method hoặc path của request không khớp Routing Rules, ví dụ gửi POST khi Route chỉ nhận GET	Đối chiếu request với mục Routing Rules, xem Xem thông tin Route.
Vẫn nhận 404 Route Not Found dù request khớp Routing Rules	Route ở trạng thái Unpublished	Đổi Status sang Published, xem Chỉnh sửa Route.
Không gửi được request tới Gateway URL	API Gateway chưa ở trạng thái Active	Kiểm tra cột Status tại danh sách API Gateway, xem Xem thông tin API Gateway.

Bước tiếp theo

• Thêm Plugin cho Route, rồi dùng cách trên để kiểm tra plugin hoạt động
• Xem thông tin Route