Quản lý các công ty và nhà phát triển sử dụng Edge

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 bạn muốn có nhiều quyền kiểm soát hơn đối với các công ty và nhà phát triển tham gia vào chương trình kiếm tiền Chương trình API (ví dụ: nếu bạn muốn thành lập 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ông ty và nhà phát triển theo cách thủ công với giao diện người dùng quản lý và API.

Một yếu tố chính cần cân nhắc khi 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 xác thực để đăng nhập vào giao diện người dùng quản lý hay không, gửi thông tin đăng nhập trong các lệnh gọi đến API quản lý Edge hoặc đăng nhập vào cổng thông tin dành cho nhà phát triển.

• Nếu nhà phát triển kiếm tiền cần có thông tin đăng nhập để truy cập vào API hoặc giao diện người dùng Edge, thì trước tiên, họ phải có thông tin đăng nhập của riêng mình Tài khoản quản trị viên Apigee.
• Nếu bạn chỉ cần tạo nhà phát triển thử nghiệm mà không cần thông tin đăng nhập (ví dụ: bạn muốn thực hiện lệnh gọi API với nhà phát triển thử nghiệm ảo), thì không có tài khoản Apigee là bắt buộc.

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ả ở 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ác công ty, như được mô tả trong các phần sau.

Khám phá trang Công ty

Truy cập trang Công ty như được mô tả bên dưới.

Thêm công ty

Cách thêm công ty:

1. Truy cập vào trang Công ty.
2. Nhấp vào + Công ty.
3. 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à công ty chính quản trị viên)
   • Loại thanh toán

   Tuỳ thuộc vào cấu hình thanh toán cho việc kiếm tiền, Loại thanh toán có thể mặc định là PREPAID hoặc POSTPAID. Để 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.

4. Thêm một hoặc nhiều nhà phát triển vào công ty.
   1. 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à phát triển khớp với chuỗi đó.
   2. Chọn một nhà phát triển trong danh sách thả xuống.
   3. Lặp lại để thêm các nhà phát triển khác vào công ty.
5. Thêm một hoặc nhiều thuộc tính tuỳ chỉnh.
   1. Trong phần Thuộc tính tuỳ chỉnh, hãy nhấp vào + Mới.
   2. Nhập tên và giá trị của thuộc tính tuỳ chỉnh.
   3. Lặp lại để thêm các thuộc tính tuỳ chỉnh bổ sung cho công ty.
6. Nhấp vào Tạo công ty.

Kích hoạt và hủy kích hoạt công ty

Cách kích hoạt và huỷ kích hoạt công ty:

1. Truy cập vào trang Công ty.
2. Đị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

Cách chỉnh sửa công ty:

1. Truy cập vào trang Công ty.
2. Di chuyển 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.
3. Cập nhật thông tin công ty, nếu cần.
4. Nhấp vào Cập nhật công ty để lưu các thay đổi.

Xoá công ty

Để xoá công ty, hãy làm như sau:

1. Truy cập vào trang Công ty.
2. Di chuyển 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.
3. 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

Cách sử dụng API để quản lý công ty và nhà phát triển được mô tả trong những phần sau.

Tạo và cập nhật công ty cũng như 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ý API Edge, 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ể chỉ định vai trò cho nhà phát triển (không bắt buộc). Để tải 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 chuyể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 về hoạt động kiếm tiền được đặt bằng API tiêu chuẩn (không kiếm tiền) trong danh sách 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 các API kiếm tiền. Thao tác này cho phép bạn thiết lập các vai trò cho các đối tác. 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 trở thành đối tác. Sau đó, những vai trò đó có thể được chỉ định cho các nhân viên cụ thể của đối tác.

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 để organizations/{org_name}/developer-roles. Khi đưa ra yêu cầu, bạn cần nêu rõ trong nội dung yêu cầu tên và mô tả về vai trò cũng như thông tin nhận dạng tổ chức. 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-roles. Ví dụ:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Câu trả lời sẽ có dạng như sau (chỉ một phần của câu trả lời được hiển thị):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Chế độ cài đặt cấu hình vai trò nhà phát triển cho API

API này sẽ hiển thị các lựa chọn cấu hình vai trò nhà phát triển sau đây:

Truy xuất thuế suất cho nhà phát triển bằng API

Bạn có thể biết thuế suất hiện tại cho 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 nêu rõ thông tin nhận dạng nhà phát triển dưới dạng 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 tác vụ khác của riêng 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 một 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 người 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 một 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ách sử dụ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 nhiệm vụ này.