upstream.ts
app/upstream.ts đặt app đứng trước một API có sẵn; request chưa có handler được chuyển tiếp sang hệ thống thật và được ghi vào nhật ký.
app/
├── upstream.ts # /api/erp → https://erp.congty.vn/api
└── erp/
└── orders/
└── get.ts # thay riêng GET /api/erp/ordersVai trò
Dùng khi thay dần một hệ thống cũ (ERP, dịch vụ đối tác): app nhận mọi request, endpoint nào đã viết handler thì handler trả lời, phần còn lại đi tiếp sang hệ thống thật. Cũng dùng để giả lập một endpoint chưa xong hay giả lỗi để thử giao diện.
Thứ tự:
- Handler của app khớp method và đường dẫn thì luôn thắng.
- Request dưới một
prefixchưa có handler được chuyển sangorigincộng phần còn lại của đường dẫn, giữ method, query, body và header (trừcookie,host). Tiền tố dài nhất được xét trước. - Ngoài mọi tiền tố thì trả 404 như thường.
Export
default một object hoặc một mảng, mỗi phần tử:
prefix: đường dẫn trong app, có/api, ví dụ"/api/erp".origin: địa chỉhttps://của hệ thống thật, viết thẳng.auth(tuỳ chọn):"forward"(mặc định) chuyển headerAuthorizationcủa người dùng sang;"service"bỏ header đó và gửiheaderscủa bạn.headers(tuỳ chọn): header gửi kèm, thường là token dịch vụ đọc từenv.log(tuỳ chọn):{ bodies: false }để không ghi body vào nhật ký.
Ví dụ
app/upstream.ts
import { env } from "manh/env";
export default [
{ prefix: "/api/erp", origin: "https://erp.congty.vn/api" },
{ prefix: "/api/pay", origin: "https://pay.partner.vn", auth: "service",
headers: { authorization: `Bearer ${env.PAY_TOKEN}` } },
];Trong handler, upstream(c) từ manh/upstream lấy câu trả lời thật để sửa, còn mock(c, data, { status, delay }) trả dữ liệu giả mà không gọi hệ thống thật.
Cần biết
originphải là chuỗihttps://tới một tên miền công khai: không IP, khônglocalhost, không tên miền nội bộ.checkbáoupstream.origin-invalid; thiếuoriginthìupstream.origin-missing.- Chỉ chuyển tiếp API. Không dùng để làm proxy cho cả một website HTML.
- Token của hệ thống thật đặt trong Secret và đọc bằng
env, không viết trong code (code.hardcoded-secret). - Bản xem trước không gọi upstream. Thử trên app đã deploy.
- Mọi request
/apiđược ghi vào nhật ký lưu lượng; header nhưauthorizationvà trường nhưpasswordđược che. - Đuôi phải là
.ts;app/upstream.tsxbị bỏ qua (config.wrong-extension).
Bước tiếp theo
- Gọi API bên ngoài — sửa câu trả lời, giả lập phần chưa xong và đọc nhật ký.
- Nhật ký và lưu lượng — xem request nào do handler, upstream hay dữ liệu giả trả lời.
Cập nhật