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 thông tin khác.

API là điểm truy cập để một ứng dụng sử dụng các chức năng của một ứng dụng khác. Bạn triển khai 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 dưới dạng một trình tự các bước thực thi để phản hồi yêu cầu từ mã ứng dụng. Bạn hiển thị một proxy API cho ứng dụng 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 về nội dung, v.v.

Mặc dù được gọi là proxy API, nhưng từ quan điểm của mã ứng dụng, đây 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ự logic của proxy API bằng cách sử dụng flow

Trong mọi ứng dụng, dữ liệu sẽ chảy qua ứng dụng 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. Flow (luồng) 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 đến tài nguyên phụ trợ, sau đó quay lại ứng dụng khách.

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

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

Proxy API có quyền truy cập vào các biến đại diện cho trạng thái thực thi. Bạn có thể truy cập vào các biến này từ tệp XML định cấu hình các chính sách và proxy API. Bạn cũng có thể truy cập các API này khi mở rộng proxy API bằng 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ữ. Một số thuộc tính tồn tại theo mặc định, thường là do các thuộc tính này phổ biến với những gì mà proxy API thực hiện (chẳng hạn như do các thuộc tính này là một phần của yêu cầu HTTP). Bạn cũng có thể tạo biến của riêng mình để đáp ứng yêu cầu về logic.

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

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

Giống như trong hầu hết ngôn ngữ lập trình, trong proxy API, bạn có thể thực thi mã 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 flow. Ví dụ: bạn có thể có một điều kiện kiểm tra tác nhân người dùng, sau đó xử lý yêu cầu tương ứng.

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

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

Hầu hết logic mà 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 khu 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 định cấu hình chính sách bằng XML để đặt 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ự "các bước" trong một luồng để proxy API thực thi logic theo thứ tự tốt nhất cho các mục tiêu của proxy.

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

Bạn có thể đưa vào các nhóm chức năng có thể sử dụng lại

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 về luồng dùng chung, hãy xem phần Luồng dùng chung có thể sử dụng lại. Để biết thêm về việc tạo chuỗi proxy API, hãy xem phần Tạo chuỗi 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 có một công cụ Theo dõi mà bạn có thể dùng để kiểm tra luồng thực thi của proxy API khi gỡ lỗi và kiểm thử. Công cụ này trình bày trực quan từng bước proxy API thực thi cho một yêu cầu. Giống 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 tính năng Theo dõi, hãy xem bài viết Sử dụng công cụ Theo dõi.

Bạn xử lý 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ề cho ứng dụng API. Trình xử lý lỗi cho phép bạn kiểm soát thông báo lỗi, cho dù lỗi đó bắt nguồn từ mã của riêng 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.