Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
Apigee X. thông tin
Có một số khái niệm là những ý tưởng phổ biến có ý nghĩa riêng trong Apigee.
| Thuật ngữ | Định nghĩa |
|---|---|
| API | Một proxy đóng vai trò là mặt tiền cho API hiện có của bạn. Thay vì gọi API hiện có, nhà phát triển bắt đầu gọi API mới do Apigee tạo. Giao diện này tách giao diện công khai khỏi API phụ trợ, giúp nhà phát triển tránh khỏi các thay đổi về phụ trợ, đồng thời cho phép bạn đổi mới ở cấp cao mà không ảnh hưởng đến các nhóm phát triển nội bộ. Khi bạn thực hiện các thay đổi về phần phụ trợ, nhà phát triển sẽ tiếp tục gọi cùng một API mà không bị gián đoạn. Trong các trường hợp nâng cao hơ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 nhà phát triển cùng một lúc. |
| Đường dẫn cơ sở và tài nguyên API | API bao gồm đường dẫn cơ sở và một tập hợp tài nguyên (còn gọi là đường dẫn tài nguyên). Đối với mỗi API, bạn xác định một URL gốc và nhiều đường dẫn tài nguyên. Bạn có thể coi API chỉ 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 dễ dàng quản lý các API, Apigee bổ sung tên hiển thị và nội dung mô tả cho các URI thô này. |
| Người dùng API | Đồng nghĩa với "nhà phát triển ứng dụng", người sử dụng các API do nhà cung cấp API tạo. |
| Nhà phát triển API | Kỹ sư phần mềm trong một tổ chức nhà cung cấp API, người xây dựng API. Các API đó được nhà phát triển ứng dụng (người dùng API) sử dụng để tạo ứng dụng. |
| Gói API | Một tập hợp các sản phẩm API được trình bày cho nhà phát triển dưới dạng một gói và thường liên kết với một gói giá. |
| Sản phẩm API | Một tập hợp tài nguyên API (URI) kết hợp với một gói dịch vụ và được trình bày cho nhà phát triển dưới dạng một gói. Sản phẩm API cũng có thể bao gồm một số siêu dữ liệu dành riêng cho doanh nghiệp của bạn để theo dõi hoặc phân tích. Bạn có thể kiếm tiền từ một hoặc nhiều tài nguyên bằng cách đưa các tài nguyên đó vào một sản phẩm API, sau đó đóng gói sản phẩm API đó để kiếm tiền. |
| Nhà cung cấp API | Nhà cung cấp API tạo API (sử dụng Edge) để người dùng API (nhà phát triển ứng dụng) sử dụng. |
| nhà phát triển ứng dụng | Trong Edge, nhà phát triển ứng dụng đăng ký ứng dụng của họ với một nhà cung cấp API. Đây là cách nhà phát triển ứng dụng nhận được các khoá API cần thiết để gọi proxy API của nhà cung cấp. |
| ứng dụng | Nhà phát triển sử dụng ứng dụng để truy cập vào tài nguyên trong các sản phẩm API của bạn. Khi tạo một ứng dụng, bạn sẽ chọn sản phẩm API cần đưa vào và Apigee sẽ tạo một khoá. Mỗi ứng dụng có một khoá duy nhất cung cấp quyền truy cập vào nhiều sản phẩm API. Ứng dụng cho phép bạn kiểm soát những người có thể truy cập vào tài nguyên của bạn. Bạn có thể kiểm soát những người có quyền truy cập vào các sản phẩm API của mình bằng cách thu hồi và làm mới khoá của ứng dụng. Ngoài ra, bạn có thể kiểm soát quyền truy cập vào các gói tài nguyên bằng cách thu hồi hoặc xoá quyền truy cập vào các sản phẩm trong ứng dụng. |
| thông tin chi tiết về số dư | Đối với nhà phát triển trả trước, số dư trong tài khoản của nhà phát triển. |
| đã đóng mức điều chỉnh | Khoản điều chỉnh đã được áp dụng trong các tài liệu thanh toán đã xuất bản. |
| tháng thanh toán đã kết thúc | Một tháng dương lịch đầy đủ mà tài liệu thanh toán đã được phát hành. |
| giới hạn tuỳ chỉnh | Giới hạn (chẳng hạn như giới hạn về số lượng giao dịch trên một sản phẩm API) mà bạn có thể thiết lập rõ ràng bằng cách sử dụng tính năng kiếm tiền. Còn được gọi là giới hạn rõ ràng. |
| gói giá theo danh mục nhà phát triển | Một gói giá áp dụng cho tất cả nhà phát triển trong một danh mục cụ thể và tất cả nhà phát triển trong danh mục đó đều có thể mua. |
| gói giá dành cho nhà phát triển | Gói giá áp dụng cho một nhà phát triển cụ thể và chỉ nhà phát triển đó mới có thể mua. |
| đã tiết lộ tác nhân | Trong luật thương mại, một người được uỷ quyền thay mặt người khác (gọi là bên uỷ quyền) để tạo mối quan hệ pháp lý với bên thứ ba. Trong hoạt động kiếm tiền, bạn có thể thiết lập mô hình thuế cho một kế hoạch chia sẻ doanh thu để nhà cung cấp API đóng vai trò là đại lý được công bố của nhà phát triển, thay mặt nhà phát triển thu thập doanh thu (và có thể là thuế bán hàng). |
| mô hình thuế đã công bố | Mô hình thuế trong đó nhà cung cấp API đóng vai trò là đại lý được công bố của nhà phát triển. |
| môi trường | Ngữ cảnh thực thi thời gian chạy cho API. Bạn phải triển khai API vào một môi trường thì mới có thể truy cập API đó trong thời gian chạy. Theo mặc định, các tổ chức Apigee được cấp phép hai môi trường: "test" và "prod". Môi trường "kiểm thử" thường được dùng để triển khai các API đang được kiểm thử. Môi trường "prod" thường được dùng để triển khai API cho mục đích sử dụng chính thức. |
| mô hình thuế kết hợp | Mô hình thuế trong đó nhà cung cấp API đóng vai trò là đại lý được công bố của nhà phát triển. Tuy nhiên, nhà cung cấp API sẽ thay mặt nhà phát triển nộp thuế bán hàng thu được từ người đăng ký cho cơ quan thuế địa phương. |
| giới hạn ngầm ẩn | Giới hạn (chẳng hạn như giới hạn số dư trả trước của nhà phát triển) do hoạt động kiếm tiền đặt ra. |
| kiếm tiền | Một thành phần của Dịch vụ dành cho nhà phát triển Apigee Edge, cung cấp một cách dễ sử dụng và linh hoạt để kiếm tiền từ các sản phẩm API. |
| số tiền đã dùng hằng tháng | Tổng mức sử dụng của nhà phát triển trong một tháng nhất định, bao gồm phí thiết lập + phí giao dịch + phí định kỳ. |
| thanh toán hằng tháng | Khoản thanh toán định kỳ do nhà phát triển thực hiện dựa trên các gói đã mua. Gói giá có thể có phí định kỳ được tính cho nhà phát triển hằng tháng, bất kể mức sử dụng. |
| câu lệnh bù trừ | Tài liệu tài chính cho thấy số dư ròng giữa các hoá đơn và báo cáo chia sẻ doanh thu. |
| mở mức điều chỉnh | Khoản điều chỉnh chưa được áp dụng trong các tài liệu thanh toán đã xuất bản. |
| tháng thanh toán mở | Một tháng dương lịch đầy đủ mà tài liệu thanh toán "cuối cùng" chưa được phát hành. |
| tổ chức | Một vùng chứa cho tất cả các đối tượng trong tài khoản Apigee, bao gồm API, sản phẩm API, gói API, ứng dụng và nhà phát triển. Bạn cần có tài khoản người dùng cho mỗi tổ chức mà bạn có thể là thành viên. (Hầu hết người dùng sẽ chỉ có một tài khoản trong một tổ chức.) Bạn cần cung cấp thông tin xác thực (tên người dùng và mật khẩu) cũng như tên tổ chức của mình với mỗi yêu cầu API mà bạn gửi. |
| danh mục gói | Danh sách các gói API. Mỗi gói được liệt kê cùng với các sản phẩm API và gói giá. |
| số dư trả trước | Số tiền mà nhà phát triển trả trước có thể dùng để thanh toán trước cho các gói API. |
| nhà phát triển trả trước | Nhà phát triển thanh toán trước để sử dụng một sản phẩm API. Khoản tiền sẽ được khấu trừ từ số dư của nhà phát triển trả trước khi sử dụng sản phẩm API. Nhà phát triển phải duy trì số dư trả trước đủ để mua sản phẩm API. Nhà cung cấp API sẽ chỉ định trạng thái trả trước hoặc trả sau cho nhà phát triển. |
| chính sách | 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 luồng API. Các chính sách thông thường bao gồm việc định tuyến các yêu cầu đến điểm cuối thích hợp, 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 giấu dữ liệu nhạy cảm khỏi người dùng bên ngoài, kiểm tra nội dung thông báo để tìm các mối đe doạ tiềm ẩn, lưu các phản hồi phổ biến vào bộ nhớ đệm để 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 ngữ 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. |
| nhà phát triển dịch vụ trả sau | Nhà phát triển được tính phí hằng tháng (thông qua hoá đơn) để sử dụng các sản phẩm API. Nhà phát triển trả phí sử dụng các sản phẩm API dựa trên các điều khoản thanh toán do(các) gói nêu trong hoá đơn đặt ra. Nhà phát triển được nhà cung cấp API chỉ định trạng thái trả sau hoặc trả trước. |
| mức giá | Một dải giá có thể áp dụng cho một sản phẩm/dịch vụ. |
| bảng giá gói giá | Một gói giá trong đó nhà phát triển phải trả một mức giá cố định hoặc biến động cho mỗi giao dịch liên quan đến một sản phẩm API kiếm tiền. |
| gói giá | Thông số kỹ thuật về các khoản phí, khoản phí khác và phần doanh thu chia sẻ cho việc sử dụng các sản phẩm API được cung cấp trong gói API kiếm tiền. |
| đường dẫn tài nguyên |
Một khái niệm RESTful, đường dẫn tài nguyên là một tài nguyên được xác định thống nhất (URI) giúp xác định đường dẫn mạng đến một tài nguyên nhất định. |
| gói tỷ lệ chia sẻ doanh thu | Một gói giá trong đó một tỷ lệ phần trăm doanh thu được tạo từ mỗi giao dịch liên quan đến một sản phẩm API kiếm tiền được chia sẻ với nhà phát triển của ứng dụng đưa ra yêu cầu. |
| kế hoạch chia sẻ doanh thu và bảng giá | Một gói giá trong đó một tỷ lệ phần trăm doanh thu được tạo từ mỗi giao dịch liên quan đến một sản phẩm API kiếm tiền được chia sẻ với nhà phát triển của ứng dụng đưa ra yêu cầu. Nhà phát triển cũng phải trả một khoản phí cố định hoặc biến đổi cho mỗi giao dịch. |
| Hoá đơn tự lập | Tài liệu tài chính được tạo thay vì bản tuyên bố chia sẻ doanh thu. Báo cáo này nêu chi tiết số tiền nhà phát triển phải trả và thay mặt nhà phát triển đóng vai trò là hoá đơn cho Nhà cung cấp API. |
| gói giá tiêu chuẩn | Gói giá mà tất cả nhà phát triển đều có thể mua. |
| tax | Tổng số thuế áp dụng cho mức sử dụng và phí của nhà phát triển. |
| nạp tiền | Hành động mà nhà phát triển trả trước thực hiện để nạp tiền vào số dư trả trước. |
| chính sách ghi lại giao dịch | Cơ chế cho phép hoạt động kiếm tiền ghi lại các thông số giao dịch và thuộc tính tuỳ chỉnh. Tính năng kiếm tiền cần thông tin này để xử lý hoạt động kiếm tiền, chẳng hạn như áp dụng gói giá cho các yêu cầu và phản hồi API dựa trên các thuộc tính tuỳ chỉnh được ghi lại trong mỗi giao dịch. |
| đại lý không được công bố | Một tổ chức (hoặc nhà điều hành) tham gia vào việc cung cấp ứng dụng cơ bản, do đó được coi là thay mặt nhà phát triển mua nội dung (chỉ cho mục đích thuế). Là một đại lý không công bố, tổ chức (hoặc nhà điều hành) có thể thu và tính thuế phải nộp của người dùng cuối. Trạng thái này chỉ liên quan đến mục đích thuế — trạng thái pháp lý của nhà phát triển trong chuỗi cung ứng sẽ không bị ảnh hưởng. |
| mô hình thuế chưa được công bố | Mô hình thuế trong đó nhà cung cấp API khấu trừ thuế đã thu của người dùng cuối và trả thuế cho cơ quan thuế địa phương. |
| phiên bản | Phiên bản 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", là gói cấu hình và chính sách được đánh số, được kiểm soát theo phiên bản, được đóng gói vào một Proxy API. Tóm lại, giao diện API có các phiên bản, còn Proxy API có các bản sửa đổi. |