Chuyển tới nội dung chính

Khái niệm cốt lõi

Khi bốn thiết kế này đã rõ ràng, mọi giao thức và kịch bản phía sau đều đơn giản:

  1. Mô hình ba thực thể: Nhóm / Môi trường / Yêu cầu liên hệ với nhau thế nào
  2. Thiết kế Pre-URL của môi trường: tại sao yêu cầu chỉ lưu đường dẫn tương đối
  3. Quy trình lắp ráp khi gửi: một lần Gửi biến cấu hình thành yêu cầu thực tế thế nào
  4. Hệ thống biến: {{variable}} được phân giải từ đâu và ba tầng biến

Mô hình ba thực thể​

Tại sao môi trường được gắn vào nhóm thay vì từng yêu cầu? Một nhóm thường đại diện cho "tất cả API của một mô-đun trong cùng một đích triển khai". Gắn ở cấp nhóm có nghĩa là chuyển môi trường sẽ chuyển cả nhóm cùng lúc — không phải sửa từng yêu cầu. Nếu một yêu cầu riêng lẻ cần môi trường khác, chỉ cần đặt nó vào một nhóm gắn với môi trường đó.


Thiết kế Pre-URL của môi trường​

Đây là thiết kế quan trọng nhất — và bị hiểu sai nhiều nhất.

Yêu cầu lưu đường dẫn tương đối; môi trường lưu địa chỉ gốc​

Trong các công cụ truyền thống, mỗi yêu cầu lưu URL đầy đủ (https://api.example.com/v1/users), nên chuyển sang môi trường kiểm thử đồng nghĩa với việc thay hàng loạt tên miền. Công cụ này đảo ngược cách làm đó:

Scheme quyết định giao thức và TLS (rất quan trọng!)​

Pre-URL được lưu theo từng giao thức, nhưng một mục thực sự phục vụ giao thức nào do scheme ở đầu URL quyết định. Scheme thể hiện cả "giao thức nào" lẫn "có mã hóa hay không (TLS)":

Giao thứcScheme thườngScheme mã hóa
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Lỗi thường gặp: địa chỉ gốc WebSocket phải được viết là ws:// / wss://. Nếu bạn gõ https://, nó bị coi là HTTP và yêu cầu WebSocket thất bại do thiếu địa chỉ gốc. Giữ dòng giao thức và scheme nhất quán.


Quy trình lắp ráp khi gửi​

Nhấn "Gửi" không mở socket ngay lập tức. Quy trình biến "yêu cầu + môi trường của nhóm + biến" từng bước thành một yêu cầu thực tế, và chèn một chuỗi hành động trước và sau cuộc gọi mạng:

Điểm mấu chốt:

  • Chuỗi hành động chỉ chạy khi "thực thi script" đang bật. Nhấn Gửi trong ứng dụng chạy chúng theo mặc định; các lần gửi tự động / MCP phải bật tường minh. Khi script tắt, token được chèn trước khi gửi hay mã hóa đơn giản là không xảy ra — đó chính là lý do kiểm soát âm "không token → 401" trong recipes hành xử như vậy.
  • Script trước khi gửi viết lại yêu cầu sắp rời đi; script sau khi nhận phản hồi viết lại phản hồi bạn nhận được. Cả hai đều có thể đọc và ghi biến thời gian chạy.

Hệ thống biến​

Có ba loại "biến" với phạm vi khác nhau. Nhầm lẫn chúng là bẫy phổ biến nhất của người mới.

{{name}} thực sự phân giải được gì?​

Ghi ở đâuBiến môi trườngBiến thời gian chạyCách dùng điển hình
{{name}} (trong URL / params / headers / body)✅❌Tham chiếu cấu hình môi trường, điền động
Đọc biến bên trong script✅✅Chuyển token đăng nhập giữa các yêu cầu, v.v.

Mẹo nhớ: {{}} chỉ thấy biến "kiểu cấu hình"; script đọc được cả ba tầng. Biến thời gian chạy là "bảng đen thời gian chạy" — chỉ script ghi được lên đó, và {{}} không bao giờ nhìn vào đó.

Tại sao {{authToken}} không đọc được token đã lưu khi đăng nhập? Vì script đăng nhập lưu nó ở tầng thời gian chạy, mà {{}} không phân tích tầng đó. Cách làm đúng là script trước khi gửi đọc nó và chèn header (xem recipes, kịch bản 1).

Biến động {{$xxx}}​

Bên trong {{}} còn có một tập biến động tích hợp sẵn, được sinh mới mỗi lần đánh giá, dùng trực tiếp trong URL / params / headers / body:

BiếnSinh ra
{{$timestamp}} / {{$timestampMs}}Unix timestamp theo giây / milli giây
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}Số nguyên ngẫu nhiên (mặc định 0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} v.v.Nhiều loại dữ liệu mẫu ngẫu nhiên

Ví dụ: GET /echo?ts={{$timestamp}}&u={{$uuid}} — trên thực tế mỗi lần gửi thay ts/u bằng giá trị thực mới.


Tóm tắt​

  • Yêu cầu lưu đoạn đường dẫn; môi trường cung cấp địa chỉ gốc theo giao thức qua Pre-URL; scheme quyết định giao thức + TLS.
  • Gửi là một quy trình lắp ráp: nối URL → nội suy → cài đặt vận chuyển → chuỗi trước khi gửi → mạng → chuỗi sau phản hồi.
  • Biến có ba tầng: {{}} đọc biến kiểu cấu hình, script đọc cả ba; chuyển token bằng script, không dùng {{}}.

Tiếp theo: scripting →