Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
Apigee X. thông tin
Nếu muốn có thêm quyền kiểm soát đối với các công ty và nhà phát triển tham gia chương trình API kiếm tiền (ví dụ: nếu bạn muốn tạo các công ty và nhà phát triển nội bộ cho mục đích thử nghiệm), bạn có thể tạo các công ty và nhà phát triển theo cách thủ công bằng API và giao diện người dùng quản lý.
Một yếu tố chính cần cân nhắc để xác định xem bạn có cần tạo công ty và nhà phát triển theo cách thủ công hay không là liệu nhà phát triển có cần thông tin đăng nhập để đăng nhập vào giao diện người dùng quản lý, gửi thông tin xác thực trong các lệnh gọi đến API Quản lý Edge hay đăng nhập vào cổng thông tin dành cho nhà phát triển hay không.
- Nếu các nhà phát triển kiếm tiền cần thông tin đăng nhập để truy cập vào giao diện người dùng hoặc API Edge, thì trước tiên, họ phải có tài khoản quản trị Apigee riêng mình.
- Nếu chỉ cần tạo nhà phát triển thử nghiệm không cần thông tin xác thực (ví dụ: nếu bạn muốn thực hiện lệnh gọi API qua nhà phát triển thử nghiệm giả định), thì bạn không cần phải có tài khoản Apigee.
Quản lý nhà phát triển ứng dụng bằng giao diện người dùng
Tạo, quản lý và kích hoạt nhà phát triển ứng dụng bằng giao diện người dùng Edge, như mô tả trong bài viết Quản lý nhà phát triển ứng dụng. Sau khi tạo nhà phát triển ứng dụng, bạn có thể thêm họ vào các công ty, như mô tả trong các phần sau.
Quản lý công ty bằng giao diện người dùng
Tạo, quản lý và kích hoạt công ty, như được mô tả trong các phần sau.
Khám phá trang Các công ty
Truy cập trang Công ty theo mô tả dưới đây.
Edge
Cách truy cập trang Công ty bằng giao diện người dùng Edge:
- Đăng nhập vào apigee.com/edge.
- Chọn Xuất bản > Kiếm tiền > Công ty trong thanh điều hướng bên trái.
Trang Công ty được hiển thị.
Như được làm nổi bật trong hình, trang Công ty cho phép bạn:
- Xem thông tin tóm tắt về tất cả các công ty, bao gồm tên công ty, mã đăng ký, số lượng ứng dụng đã đăng ký và khoá API, loại thanh toán, số lượng nhà phát triển được chỉ định cho công ty và trạng thái
- Thêm công ty
- Kích hoạt hoặc huỷ kích hoạt công ty
- Chỉnh sửa công ty
- Xoá công ty
- Tìm kiếm danh sách công ty
Phiên bản cũ (Đám mây riêng tư)
Cách truy cập vào trang Công ty bằng giao diện người dùng Classic Edge:
- Đăng nhập vào
http://ms-ip:9000
, trong đó ms-ip là địa chỉ IP hoặc tên DNS của nút Máy chủ quản lý. - Chọn Xuất bản > Công ty ở thanh điều hướng trên cùng.
Trang Công ty được hiển thị.
- Xem danh sách các công ty hiện tại
- Quản lý công ty. Thêm, kích hoạt, chỉnh sửa và xoá công ty một cách cụ thể.
- Xem cổng thông tin dành cho nhà phát triển được kết nối (chỉ dành cho Drupal 7)
Thêm công ty
Cách thêm công ty:
- Truy cập trang Công ty.
- Nhấp vào + Công ty.
- Nhập thông tin chi tiết về công ty.
Các trường bắt buộc bao gồm:
- Tên công ty
- Quản trị viên (người dùng là quản trị viên chính của công ty)
- Loại thanh toán
Tuỳ thuộc vào cấu hình thanh toán kiếm tiền, Loại thanh toán có thể mặc định là
PREPAID
hoặcPOSTPAID
. Để biết thêm thông tin, hãy xem bài viết Định cấu hình loại thanh toán trả trước và trả sau bằng API. - Thêm một hoặc nhiều nhà phát triển vào công ty.
- Trong phần Nhà phát triển, hãy nhập một chuỗi vào trường Thêm nhà phát triển để hiển thị danh sách những nhà phát triển khớp với chuỗi đó.
- Chọn một nhà phát triển trong danh sách thả xuống.
- Lặp lại bước trên để thêm các nhà phát triển khác vào công ty.
- Thêm một hoặc nhiều thuộc tính tuỳ chỉnh.
- Trong mục Thuộc tính tuỳ chỉnh, hãy nhấp vào + Mới.
- Nhập tên và giá trị của thuộc tính tuỳ chỉnh.
- Lặp lại thao tác này để thêm các thuộc tính tuỳ chỉnh bổ sung vào công ty.
- Nhấp vào Tạo công ty.
Kích hoạt và huỷ kích hoạt công ty
Để kích hoạt và huỷ kích hoạt một công ty:
- Truy cập vào trang Công ty.
- Định vị con trỏ lên công ty bạn muốn kích hoạt và bật trong trình đơn thao tác.
Tắt nút bật/tắt để huỷ kích hoạt công ty.
Chỉnh sửa công ty
Để chỉnh sửa công ty:
- Truy cập vào trang Công ty.
- Định vị con trỏ lên công ty bạn muốn chỉnh sửa và nhấp vào trong trình đơn thao tác.
- Cập nhật thông tin công ty, theo yêu cầu.
- Nhấp vào Cập nhật công ty để lưu thay đổi.
Xoá công ty
Để xoá công ty:
- Truy cập trang Công ty.
- Định vị con trỏ lên công ty mà bạn muốn xóa và nhấp vào trong trình đơn thao tác.
- Nhấp vào Xoá để xác nhận thao tác xoá.
Quản lý công ty và nhà phát triển bằng API
Việc sử dụng API để quản lý các công ty và nhà phát triển được mô tả trong các phần sau.
Tạo và cập nhật công ty và nhà phát triển bằng API
Để quản lý các công ty và nhà phát triển bằng API Quản lý cạnh API, hãy tham khảo các phần API sau:
- Tạo công ty
- Tạo nhà phát triển
Lưu ý: Định cấu hình thông tin kiếm tiền khi tạo nhà phát triển bằng cách truyền các thuộc tính tuỳ chỉnh. - Thêm hoặc cập nhật nhà phát triển của công ty
Lưu ý: Bạn có thể tuỳ ý chỉ định vai trò cho nhà phát triển (không bắt buộc). Để xem danh sách vai trò của nhà phát triển, hãy xem phần Truy xuất vai trò của nhà phát triển. - Liệt kê cấu hình kiếm tiền cho tất cả nhà phát triển hoặc cho một nhà phát triển
Lưu ý: Hãy xác định thông tin kiếm tiền bằng cách truyền các thuộc tính tuỳ chỉnh khi tạo hoặc cập nhật nhà phát triển. Bạn có thể xem các thuộc tính tuỳ chỉnh cho hoạt động kiếm tiền được thiết lập bằng cách sử dụng API tiêu chuẩn (không kiếm tiền) để liệt kê tất cả nhà phát triển hoặc một nhà phát triển.
Quản lý vai trò của nhà phát triển bằng API
Bạn có thể tạo vai trò bằng API kiếm tiền. Điều này cho phép bạn thiết lập vai trò cho đối tác của mình. Ví dụ: bạn có thể thiết lập vai trò quản trị viên và nhà phát triển ứng dụng cho một đối tác. Sau đó, bạn có thể chỉ định các vai trò đó cho các nhân viên đối tác cụ thể.
Tạo vai trò nhà phát triển
Để tạo vai trò nhà phát triển, hãy gửi yêu cầu POST đến organizations/{org_name}/developer-roles
. Khi đưa ra yêu cầu, bạn cần nêu rõ tên và thông tin mô tả về vai trò cũng như thông tin nhận dạng tổ chức trong nội dung yêu cầu. Ví dụ:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "name": "appDeveloper", "description": "App Developer", "organization": { "id": "{org_name}" } }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \ -u email:password
Truy xuất vai trò của nhà phát triển
Để truy xuất vai trò của nhà phát triển, hãy gửi yêu cầu GET tới tổ chức/{org_id}/developer-vai trò. Ví dụ:
$ curl -H "Accept:application/json" -X GET \ "https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \ -u email:password
Phản hồi sẽ có dạng như sau (chỉ hiển thị một phần nội dung của phản hồi):
{ "description" : "App Developer", "id" : "appdeveloper", "name" : "appDeveloper", "organization" : { ... } }
Chế độ cài đặt cấu hình vai trò nhà phát triển trong API
API sẽ hiển thị các tuỳ chọn cấu hình vai trò nhà phát triển sau đây:
Tên | Nội dung mô tả | Mặc định | Bắt buộc? |
---|---|---|---|
name |
Tên vai trò nhà phát triển. |
Không áp dụng | Có |
description |
Mô tả vai trò nhà phát triển. |
Không áp dụng | Có |
Truy xuất thuế suất cho nhà phát triển bằng API
Bạn có thể nhận mức thuế hiện tại cho một nhà phát triển bằng cách gửi yêu cầu GET tới organizations/{org_name}/tax-engine
. Khi đưa ra yêu cầu, bạn cần chỉ định thông tin nhận dạng nhà phát triển làm tham số truy vấn. Ví dụ:
$ curl -H "Accept:application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \ -u email:password
Phản hồi sẽ có dạng như sau:
0.09
Thực hiện các thao tác khác dành riêng cho nhà phát triển bằng API
Nhiều công việc liên quan đến kiếm tiền mà bạn có thể thực hiện cho tổ chức (chẳng hạn như tạo kế hoạch giá hoặc tạo điều kiện thông báo). Bạn cũng có thể thực hiện cho từng nhà phát triển. Ví dụ: bạn có thể tạo tài khoản ngân hàng cho một nhà phát triển cụ thể hoặc tạo báo cáo doanh thu cho một nhà phát triển cụ thể.
Bảng sau đây liệt kê các thao tác dành riêng cho nhà phát triển mà bạn có thể thực hiện bằng các API kiếm tiền. Bảng này cũng liệt kê nơi bạn có thể tìm thấy hướng dẫn chi tiết về cách thực hiện các tác vụ này.
Việc cần làm | Tìm hướng dẫn ở đâu |
---|---|
Xem các điều khoản và điều kiện mà nhà phát triển đã chấp nhận |
Xem các điều khoản và điều kiện mà nhà phát triển hoặc công ty chấp nhận bằng API |
Xem các gói API được nhà phát triển chấp nhận |
Xem các gói sản phẩm API được nhà phát triển hoặc công ty chấp nhận bằng API |
Tạo gói giá dành cho nhà phát triển | |
Xem các gói giá dành cho nhà phát triển | |
Xem các gói giá được cung cấp cho một nhà phát triển cụ thể có chứa một sản phẩm cụ thể |
Xem gói giá được chấp nhận cho nhà phát triển chứa sản phẩm API bằng API |
Chỉ xem các gói giá được chấp nhận dành cho nhà phát triển |
Xem tất cả các gói giá được nhà phát triển chấp nhận bằng API này |
Cấp tín dụng cho nhà phát triển | |
Đặt hạn mức tín dụng cho nhà phát triển | |
Xem hạn mức tín dụng của nhà phát triển | |
"Nạp tiền" (thêm số tiền vào) số dư trả trước của nhà phát triển | |
Xem số dư trả trước của nhà phát triển | |
Thiết lập điều kiện thông báo cho nhà phát triển | |
Tạo và xem định nghĩa trong báo cáo về một nhà phát triển |