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.
Truy cập vào tài liệu Apigee X.
thông tin

Chủ đề này liệt kê một số đặc điểm cơ bản của các 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 các proxy API để tạo API

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

Mặc dù được gọi là một proxy API, nhưng theo quan điểm của mã ứng dụng, đó là API.

Để biết thông tin tổng quan về các 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 các luồng

Trong mọi ứng dụng, dữ liệu sẽ truyền qua ứng dụng theo logic điều kiện. Trong Apigee Edge, đường dẫn 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 một proxy API. 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ừ máy khách đến tài nguyên phụ trợ, sau đó quay lại máy khách.

Để biết thêm thông tin về luồng, hãy xem phần Kiểm soát cách một proxy thực thi bằng 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

Một 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ừ XML định cấu hình các chính sách và proxy API. Bạn cũng có thể truy cập vào các biến này khi mở rộng một proxy API bằng ngôn ngữ lập trình, chẳng hạn như Java, JavaScript hoặc Python.

Các biến này do Apigee Edge lưu giữ. Một số thuộc tính tồn tại theo mặc định, thường là do chúng phổ biến đối với những gì mà các proxy API thực hiện (chẳng hạn như vì chúng là một phần của 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 một yêu cầu logic.

Để biết thêm thông tin 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ể để các proxy API thực thi có điều kiện

Giống như trong hầu hết các ngôn ngữ lập trình, trong các proxy API, bạn có thể thực thi mã có điều kiện. Các điều kiện thường dựa trên trạng thái của 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ể 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 cho phù hợp.

Để biết thêm thông tin 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 một 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 một proxy API đều được đóng gói dưới dạng các chính sách. Chính sách là một thành phần của Apigee Edge, có chức năng đó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 định cấu hình 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 một trình tự "các bước" trong một luồng, để proxy API của bạn 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 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 bộ chức năng có thể sử dụng lại

Khi proxy API của bạn có logic sẽ được dùng ở nhiều nơi 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 nơi. Ví dụ: bạn có thể nhóm logic bảo mật trong một quy trình dùng chung mà các proxy API khác gọi, giảm 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ể sử dụng lại. Để biết thêm thông tin về việc liên kết các proxy API, hãy xem bài viết Liên kết các proxy API với nhau.

Bạn có thể gỡ lỗi một 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 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 trực quan từng bước của proxy API 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 của proxy API.

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

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 một ứ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.