Basic terminology

Giao diện lập trình ứng dụng – một giao diện giúp một ứng dụng dễ dàng sử dụng các chức năng hoặc dữ liệu từ một ứng dụng khác.

Bằng cách xác định các điểm truy cập ổn định và đơn giản vào logic và dữ liệu ứng dụng, API cho phép nhà phát triển dễ dàng truy cập và sử dụng lại logic ứng dụng do các nhà phát triển khác tạo. Trong trường hợp Web API, logic và dữ liệu đó được hiển thị trên mạng. Vì các ứng dụng sử dụng API rất nhạy cảm với các thay đổi, nên API cũng ngụ ý một hợp đồng. Hợp đồng này đảm bảo rằng theo thời gian, API sẽ thay đổi theo cách có thể dự đoán được.

Apigee cung cấp nhiều thông tin về API và các phương pháp hay nhất để phát triển và sử dụng API. Để bắt đầu, hãy xem webcast về Thiết kế API hoặc tải sách điện tử miễn phí Thiết kế API web: Các phương pháp hay còn thiếu để tạo ra những giao diện mà nhà phát triển yêu thích.

Một lớp mặt nạ trên Edge cho một hoặc nhiều API, dịch vụ HTTP chung hoặc ứng dụng (chẳng hạn như Node.js).

Một proxy API được triển khai dưới dạng một tập hợp các tệp cấu hình, chính sách và mã dựa trên một tập hợp các tài nguyên do Apigee Edge cung cấp. Bạn có thể tạo và định cấu hình các proxy API bằng giao diện người dùng quản lý Apigee Edge hoặc có thể triển khai cục bộ trong một trình chỉnh sửa văn bản hoặc IDE.

Lớp mặt nạ do một proxy API cung cấp sẽ tách API hướng đến nhà phát triển khỏi các dịch vụ phụ trợ, giúp nhà phát triển không phải chịu ảnh hưởng của các thay đổi về mã và cho phép đổi mới ở rìa mà không ảnh hưởng đến các nhóm phát triển nội bộ của bạn. Khi các nhóm phát triển thực hiện các thay đổi về phần phụ trợ, nhà phát triển vẫn tiếp tục gọi cùng một giao diện mà không bị gián đoạn. Apigee cho phép bạn hiển thị nhiều giao diện cho cùng một API, giúp bạn tuỳ chỉnh chữ ký của một API để đáp ứng nhu cầu của nhiều phân khúc nhà phát triển cùng một lúc.

Các API được xác định bằng địa chỉ mạng và URI. API bao gồm một đường dẫn cơ sở và một tập hợp tài nguyên API. Mỗi proxy API xác định một đường dẫn cơ sở và (không bắt buộc) nhiều đường dẫn tài nguyên API. Bạn có thể coi API đơn giản là một tập hợp các URI, tất cả đều có chung một đường dẫn cơ sở.

Để giúp bạn quản lý API dễ dàng hơn, Apigee sẽ tăng cường các URI thô này bằng tên và nội dung mô tả hiển thị. Edge cho phép bạn đính kèm các chính sách và mã vào URI, cho phép kiểm soát và quản lý chi tiết hành vi của API.

Một tập hợp các tài nguyên API (URI) kết hợp với một hạn mức hoặc gói dịch vụ được xuất bản cho nhà phát triển ứng dụng tại thời điểm thiết kế. Đến lượt, các sản phẩm API có thể được đóng gói thành các gói API để kiếm tiền.

Khoá API được liên kết với một hoặc nhiều sản phẩm API, thực thi mối liên kết giữa một ứng dụng và gói URI mà ứng dụng được phép sử dụng.

Từ viết tắt của ứng dụng. Thuật ngữ ứng dụng dùng để chỉ các ứng dụng di động sử dụng API. Nhà phát triển triển khai ứng dụng bằng nhiều ngôn ngữ lập trình, đồng thời sử dụng nhiều công nghệ và nền tảng. Những nhà phát triển muốn sử dụng API sẽ đăng ký ứng dụng trong tổ chức của nhà cung cấp API trên Apigee Edge.

Khi ứng dụng được đăng ký, Apigee sẽ tạo một khoá API và bí mật để xác định ứng dụng. Nhà phát triển nhúng khoá API vào ứng dụng, khoá này sẽ xuất hiện khi đưa ra yêu cầu. Dịch vụ API triển khai biện pháp bảo mật cho khoá API thông qua quy trình xác thực khoá API trực tiếp hoặc thông qua OAuth.

Ngữ cảnh thực thi thời gian chạy cho các proxy API. Bạn phải triển khai một proxy API vào một môi trường thì API mà proxy đó hiển thị mới có thể truy cập được qua mạng. Theo mặc định, các tổ chức được cung cấp 2 môi trường: kiểm thử và phát hành công khai.

• Môi trường test (kiểm thử) thường được dùng để triển khai các proxy API trong quá trình phát triển.
• Môi trường prod thường được dùng để quảng bá các proxy API từ môi trường kiểm thử sau khi chúng được phát triển và kiểm thử đầy đủ.

Một vùng chứa cho tất cả các đối tượng trong tài khoản Apigee Edge, bao gồm cả các proxy API, sản phẩm API, gói API, ứng dụng và nhà phát triển.

Mỗi tổ chức mà bạn là thành viên đều phải có một tài khoản người dùng. (Hầu hết người dùng sẽ chỉ có tài khoản trong một tổ chức.)

Một bước xử lý thực thi dưới dạng một đơn vị logic nguyên tử, có thể sử dụng lại trong quy trình xử lý proxy API.

Chức năng dựa trên chính sách thông thường bao gồm việc chuyển đổi định dạng thông báo, thực thi quyền kiểm soát truy cập, gọi các dịch vụ từ xa để biết thêm thông tin, che dữ liệu nhạy cảm của người dùng bên ngoài, kiểm tra nội dung thông báo để phát hiện các mối đe doạ tiềm ẩn, lưu vào bộ nhớ đệm các phản hồi phổ biến để cải thiện hiệu suất, v.v.

Các chính sách có thể được thực thi có điều kiện dựa trên nội dung hoặc bối cảnh của một yêu cầu hoặc thông báo phản hồi. Ví dụ: chính sách chuyển đổi có thể được thực thi để tuỳ chỉnh định dạng phản hồi nếu thông báo yêu cầu được gửi từ điện thoại thông minh.

Phiên bản của giao diện API dành cho nhà phát triển.

Ví dụ: pivotaltracker.com/services/v3 hoặc api.enterprise.apigee.com/v1.

Thuật ngữ này khác với bản sửa đổi. Bản sửa đổi là gói cấu hình và chính sách được đánh số, kiểm soát phiên bản, được đóng gói vào một Proxy API. Giao diện API có các phiên bản; proxy API có các bản sửa đổi.