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
Có một số khái niệm là những ý tưởng phổ biến nhưng lại có ý nghĩa riêng trong Apigee.
| Thuật ngữ | Định nghĩa |
|---|---|
| API | Một proxy đóng vai trò là lớp ngoài 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. Lớp mặt nạ này tách rời giao diện công khai của bạn khỏi API phụ trợ, giúp nhà phát triển không bị ảnh hưởng bởi các thay đổi ở phần phụ trợ, đồng thời cho phép bạn đổi mới ở rìa 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 vẫn 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 phân khúc 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 các 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 duy nhất và nhiều đường dẫn tài nguyên. 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ý các API dễ dàng hơn, Apigee sẽ tăng cường các URI thô này bằng tên hiển thị và nội dung mô tả. |
| 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 ra. |
| Nhà phát triển API | Một kỹ sư phần mềm trong tổ chức 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 cung cấp 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 các 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 các 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 để giám sát hoặc số liệu 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 đó, bạn có thể kết hợp sản phẩm API này vào một gói API để kiếm tiền. |
| Nhà cung cấp API | Nhà cung cấp API tạo API (bằ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 các proxy API của nhà cung cấp. |
| ứng dụng | Nhà phát triển của bạn sử dụng các ứ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 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 để 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. 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 một ứng dụng. |
| chi tiết 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. |
| mức điều chỉnh đã đóng | Khoản điều chỉnh đã được áp dụng trong các chứng từ thanh toán đã phát hành. |
| tháng thanh toán đã kết thúc | Một tháng dương lịch hoàn chỉnh mà chứng từ thanh toán đã được xuất. |
| giới hạn tuỳ chỉnh | Một 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à hạn mức 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 | Một 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. |
| nhân viên hỗ trợ được công bố | Trong luật thương mại, một người được uỷ quyền hành động thay mặt cho 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ột mô hình thuế cho kế hoạch chia sẻ doanh thu sao cho nhà cung cấp API đóng vai trò là một đại lý được công bố của nhà phát triển để thu thập doanh thu (và có thể là thuế bán hàng) thay mặt cho nhà phát triển. |
| mô hình thuế được công bố | Một mô hình thuế trong đó nhà cung cấp API đóng vai trò là đại lý công khai của nhà phát triển. |
| môi trường | Ngữ cảnh thực thi thời gian chạy cho các API. Bạn phải triển khai một API vào một môi trường thì mới có thể truy cập vào API đó trong thời gian chạy. Theo mặc định, các tổ chức Apigee được cung cấp hai môi trường: "test" và "prod". Môi trường "test" (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ột mô hình thuế trong đó nhà cung cấp API đóng vai trò là đại lý công khai của nhà phát triển. Tuy nhiên, nhà cung cấp API sẽ thay mặt nhà phát triển thanh toán 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 | Một 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 tính nă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 đã sử 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ỳ mà 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ỳ mà nhà phát triển phải trả mỗi tháng, bất kể mức sử dụng. |
| bảng kê bù trừ | Một chứng từ tài chính cho thấy số dư ròng giữa hoá đơn và báo cáo chia sẻ doanh thu. |
| mở chế độ điều chỉnh | Khoản điều chỉnh chưa được áp dụng trong các chứng từ thanh toán đã phát hành. |
| tháng thanh toán mở | Một tháng dương lịch hoàn chỉnh mà Google chưa phát hành chứng từ thanh toán "cuối cùng". |
| tổ chức | Một vùng chứa cho tất cả các đối tượng trong tài khoản Apigee của bạn, bao gồm cả 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 có thể 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.) Bạn cần cung cấp thông tin đăng nhập (tên người dùng và mật khẩu) và tên của tổ chức trong 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á của gói đó. |
| số dư trả trước | Số tiền mà nhà phát triển trả trước có thể 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 cho việc sử dụng một sản phẩm API. Tiền sẽ được khấu trừ từ số dư của nhà phát triển trả trước khi sản phẩm API được sử dụng. 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 một quy trình API. Các chính sách điển hình 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 để 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 thông báo yêu cầu hoặc phản hồi. Ví dụ: một 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 trả sau | Nhà phát triển được lập hoá đơn hằng tháng (thông qua hoá đơn) cho việc sử dụng các sản phẩm API. Nhà phát triển thanh toán cho việc 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 có trong hoá đơn đặt ra. Nhà cung cấp API sẽ chỉ định trạng thái trả sau hoặc trả trước cho nhà phát triển. |
| mức giá | Một phạm vi giá có thể có mà bạn có thể dùng để tiếp thị một mặt hàng. |
| gói giá theo bảng giá | Một gói giá mà nhà phát triển phải trả một mức giá cố định hoặc linh hoạt cho mỗi giao dịch liên quan đến một sản phẩm API được kiếm tiền. |
| gói giá | Quy cách về các khoản phí, các khoản phí khác và phần doanh thu chia sẻ khi sử dụng các sản phẩm API được cung cấp trong một gói API có tính phí. |
| resource path |
Một khái niệm RESTful, đường dẫn tài nguyên là một giá trị nhận dạng tài nguyên thống nhất (URI) xác định đường dẫn mạng đến một tài nguyên nhất định. |
| kế hoạch tỷ lệ chia sẻ doanh thu | Một gói giá trong đó 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 được kiếm tiền sẽ được chia sẻ với nhà phát triển ứng dụng đưa ra yêu cầu. |
| tỷ lệ chia sẻ doanh thu và kế hoạch bảng giá | Một gói giá trong đó 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 được kiếm tiền sẽ được chia sẻ với nhà phát triển ứ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 linh hoạt cho mỗi giao dịch. |
| hoá đơn tự lập | Một chứng từ tài chính được tạo thay vì một báo cáo chia sẻ doanh thu. Báo cáo này nêu chi tiết số tiền mà nhà phát triển phải trả và đóng vai trò là hoá đơn gửi cho Nhà cung cấp API thay mặt cho nhà phát triển. |
| gói giá tiêu chuẩn | Một gói cước mà tất cả nhà phát triển đều có thể mua. |
| tax | Tổng thuế áp dụng cho mức sử dụng và phí của nhà phát triển. |
| top up | Thao tác 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 nhận giao dịch | Một 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. Hoạt động kiếm tiền cần thông tin này để thực hiện quy trình xử lý hoạt động kiếm tiền, chẳng hạn như áp dụng kế hoạch 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ông khai | 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, theo đó, tổ chức này được coi là mua nội dung thay cho nhà phát triển (chỉ cho mục đích thuế). Là một đại lý không công khai, tổ chức (hoặc nhà điều hành) có thể thu và chịu trách nhiệm về các khoản thuế mà người dùng cuối phải trả. 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 không bị ảnh hưởng. |
| mô hình thuế không được tiết lộ | Một mô hình thuế trong đó nhà cung cấp API khấu trừ thuế thu được từ người dùng cuối và trả cho cơ quan thuế địa phương. |
| Phiên bản | 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", 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 API Proxy. Nói tóm lại, các giao diện API có phiên bản, trong khi API Proxy có bản sửa đổi. |