Skip to Content

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/orders

Vai 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 prefix chưa có handler được chuyển sang origin cộ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 header Authorization của người dùng sang; "service" bỏ header đó và gửi headers củ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

  • origin phải là chuỗi https:// tới một tên miền công khai: không IP, không localhost, không tên miền nội bộ. check báo upstream.origin-invalid; thiếu origin thì 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ư authorization và trường như password được che.
  • Đuôi phải là .ts; app/upstream.tsx bị bỏ qua (config.wrong-extension).

Bước tiếp theo

Cập nhật