Cách chia sẻ header (ví dụ: Token) trong tài liệu trực tuyến của Apidog?

Tôi phải nhập thủ công cùng một header mỗi lần sử dụng “Try It” để kiểm thử API. Có cách nào để chia sẻ header đó tự động không?

Có. Bạn nên sử dụng biến để chia sẻ header giữa các yêu cầu API. Dưới đây là hai cách tiếp cận phổ biến:

Phương pháp 1: Sử dụng biến trực tiếp trong header của API

Thiết lập header như sau trong định nghĩa API của bạn:

Khi sử dụng tính năng “Try It” trong tài liệu trực tuyến, người dùng chỉ cần nhập giá trị ACCESS_TOKEN một lần ở phía trên. Tất cả API tham chiếu đến {{ACCESS_TOKEN}} sẽ tự động điền giá trị—không cần nhập lặp lại.

Phương pháp 2: Định nghĩa tham số header toàn cục bằng biến

Đi tới Quản lý môi trường → Tham số toàn cục

Thêm một tham số kiểu header, ví dụ:

Các API trong dự án sẽ sử dụng tham số toàn cục này theo mặc định. Bạn cũng có thể chọn bật hoặc tắt tham số này cho các API cụ thể.

Tài liệu trực tuyến sẽ tự động kế thừa giá trị biến, cho phép nhiều API cùng chia sẻ giá trị đó.

Dù bạn định nghĩa biến trực tiếp trong header của API hay tham chiếu biến đó thông qua tham số toàn cục, miễn là sử dụng cùng một tên biến (ví dụ: {{ACCESS_TOKEN}}), bạn chỉ cần nhập biến đó một lần trong tài liệu trực tuyến. Sau đó, biến sẽ được chia sẻ trên tất cả các yêu cầu liên quan—giúp cải thiện đáng kể trải nghiệm kiểm thử.

Cách chia sẻ header (ví dụ: Token) trong tài liệu trực tuyến của Apidog?

Phương pháp 1: Sử dụng biến trực tiếp trong header của API#

Phương pháp 2: Định nghĩa tham số header toàn cục bằng biến#

Phương pháp 1: Sử dụng biến trực tiếp trong header của API

Phương pháp 2: Định nghĩa tham số header toàn cục bằng biến