Các điểm chính trong quá trình phát triển proxy API

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Chủ đề này liệt kê một số đặc điểm cơ bản của proxy API, cùng với các đường liên kết đến các thông tin khác.

API là điểm truy cập cho một ứng dụng để sử dụng khả năng của một ứng dụng khác. Bạn triển khai các proxy API để tạo API

Trong Apigee Edge, bạn triển khai proxy API bằng cách định cấu hình logic proxy API theo trình tự các bước sẽ thực thi để phản hồi yêu cầu từ mã ứng dụng. Bạn hiển thị proxy API cho ứng dụng khách bằng cách xác định các điểm cuối bao gồm URL có đường dẫn tài nguyên, động từ HTTP, yêu cầu nội dung, v.v.

Mặc dù được gọi là proxy API, nhưng nhìn từ phía mã ứng dụng, đó là API.

Để biết thông tin tổng quan về proxy API, hãy xem bài viết Tìm hiểu về API và proxy API.

Bạn sắp xếp trình tự của logic proxy API bằng cách sử dụng các luồng

Trong mọi ứng dụng, dữ liệu di chuyển qua ứng dụng được hướng dẫn theo logic điều kiện. Trong Apigee Edge, lộ trình xử lý được tạo thành từ các luồng. Luồng là một chuỗi các giai đoạn (hoặc "bước") tạo nên đường dẫn xử lý của proxy API. Luồng (flow) là cách Apigee Edge cung cấp các vị trí để bạn áp dụng logic và hành vi tại các vị trí cụ thể, từ ứng dụng khách cho đến tài nguyên phụ trợ, sau đó quay lại ứng dụng.

Để biết thêm thông tin về luồng, hãy xem phần Kiểm soát cách proxy thực thi thông qua luồng

Bạn truy cập vào dữ liệu trạng thái thông qua các biến luồng do các proxy API tạo

Proxy API có quyền truy cập vào các biến biểu thị trạng thái thực thi. Bạn có thể truy cập vào những biến này từ tệp XML giúp định cấu hình proxy và chính sách API. Bạn cũng có thể truy cập vào các API này khi mở rộng proxy API bằng một ngôn ngữ quy trình, chẳng hạn như Java, JavaScript hoặc Python.

Các biến này do Apigee Edge giữ lại. Một số giá trị tồn tại theo mặc định, thường là do chúng phổ biến với những gì các proxy API thực hiện (chẳng hạn như vì chúng thuộc một yêu cầu HTTP). Bạn cũng có thể tạo các biến của riêng mình để đáp ứng yêu cầu về logic.

Để biết thêm về các biến, hãy xem bài viết Quản lý trạng thái proxy bằng các biến luồng.

Bạn có thể yêu cầu các proxy API thực thi theo điều kiện

Giống như trong hầu hết các ngôn ngữ lập trình, trong proxy API, bạn có thể yêu cầu mã thực thi theo điều kiện. Các điều kiện thường dựa trên trạng thái proxy API mà bạn có thể truy cập thông qua các biến luồng. Ví dụ: bạn có thể tạo một điều kiện kiểm tra tác nhân người dùng, sau đó xử lý yêu cầu cho phù hợp.

Để biết thêm về quá trình thực thi có điều kiện, hãy xem phần Biến luồng và điều kiện.

Bạn triển khai hầu hết logic trong proxy API bằng các chính sách

Hầu hết logic bạn thêm vào proxy API đều được đóng gói dưới dạng chính sách. Chính sách là một thành phần Apigee Edge đóng gói logic cho một lĩnh vực chức năng, chẳng hạn như bảo mật hoặc quản lý lưu lượng truy cập. Bạn thiết lập một chính sách bằng XML để đặt các thuộc tính cho logic cơ bản. Bạn sắp xếp các chính sách theo trình tự gồm "các bước" trong một luồng để proxy API thực thi logic theo thứ tự phù hợp nhất cho các mục tiêu của proxy.

Để biết thêm thông tin về chính sách, hãy xem phần Chính sách là gì?.

Bạn có thể đưa vào các tập hợp chức năng có thể tái sử dụng

Khi proxy API của bạn bao gồm logic sẽ được sử dụng từ nhiều vị trí trong mã của bạn (chẳng hạn như các proxy API khác), bạn có thể thu thập logic đó cho các lệnh gọi từ nhiều vị trí. Ví dụ: bạn có thể nhóm logic bảo mật trong một luồng dùng chung mà các proxy API khác gọi, giúp giảm tình trạng trùng lặp trên các proxy API.

Để biết thêm thông tin về luồng dùng chung, hãy xem phần Luồng dùng chung có thể tái sử dụng. Để biết thêm về việc tạo chuỗi proxy API, hãy xem phần Liên kết các proxy API với nhau.

Bạn có thể gỡ lỗi proxy bằng công cụ Theo dõi

Apigee Edge cung cấp một công cụ Theo dõi mà bạn có thể dùng để kiểm tra quy trình thực thi của proxy API khi gỡ lỗi và kiểm thử. Công cụ này trình bày một cách trực quan từng bước proxy API sẽ thực thi cho một yêu cầu. Như trong trình gỡ lỗi, ở mỗi bước, bạn có thể xem danh sách các giá trị biến tạo nên trạng thái proxy API.

Để biết thêm về cách gỡ lỗi bằng công cụ Theo dõi, hãy xem bài viết Sử dụng công cụ Theo dõi.

Bạn xử lý các lỗi proxy API dưới dạng lỗi

Bằng cách định cấu hình trình xử lý lỗi, bạn có thể tuỳ chỉnh lỗi được trả về ứng dụng API. Trình xử lý lỗi cho phép bạn kiểm soát các thông báo lỗi để xác định xem lỗi bắt nguồn từ mã của bạn hay từ một thành phần đi kèm (chẳng hạn như chính sách).

Để biết thêm thông tin, hãy xem phần Xử lý lỗi.