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.
Truy cập vào tài liệu Apigee X. thông tin

Nếu muốn có nhiều quyền kiểm soát hơn đối với những công ty và nhà phát triển tham gia chương trình API có tính năng kiếm tiền của bạn (ví dụ: nếu muốn tạo các công ty và nhà phát triển nội bộ cho mục đích kiểm thử), 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 quyết định việc 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 đăng nhập trong các lệnh gọi đến API quản lý Edge hay đăng nhập vào một cổng thông tin dành cho nhà phát triển hay không.

• Nếu cần thông tin đăng nhập để truy cập vào Giao diện người dùng Edge hoặc API, trước tiên, nhà phát triển kiếm tiền phải có tài khoản quản trị viên Apigee riêng.
• Nếu chỉ cần tạo nhà phát triển kiểm thử không cần thông tin đăng nhập (ví dụ: nếu bạn muốn thực hiện lệnh gọi API với nhà phát triển kiểm thử giả định), thì bạn không cần 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 phần 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ư mô tả trong các phần sau.

Khám phá trang Công ty

Truy cập vào trang Công ty, như 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à quản trị viên chính của công ty)
   • Loại thanh toán

   Tuỳ thuộc vào chế độ thiết lập thông tin thanh toán để kiếm tiền, Loại hình 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 các 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 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 mục 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 tùy chỉnh.
   3. Lặp lại để thêm các thuộc tính tuỳ chỉnh khác cho công ty.
6. Nhấp vào Tạo công ty.

Kích hoạt và huỷ kích hoạt công ty

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

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 kích hoạt và bật trong trình đơn thao tác.
   Tắt nút chuyển để 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 mà bạn muốn chỉnh sửa rồi nhấp vào biểu tượng trong trình đơn hành động.
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

Cách xoá một công ty:

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 xoá rồi nhấp vào biểu tượng 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

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 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). Để xem danh sách các 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 ý: 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 một nhà phát triển. Bạn có thể xem các thuộc tính tuỳ chỉnh kiếm tiền được đặt bằ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ò nhà phát triển bằng API

Bạn có thể tạo vai trò bằng API kiếm tiền. Nhờ đó, bạn có thể thiết lập vai trò cho các đố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 những vai trò đó cho 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 một yêu cầu POST đến organizations/{org_name}/developer-roles. Khi đưa ra yêu cầu, bạn cần chỉ định tên và nội dung mô tả của vai trò cũng như thông tin nhận dạng của 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ò nhà phát triển

Để truy xuất các vai trò của nhà phát triển, hãy gửi yêu cầu GET đến organizations/{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

Phản hồi sẽ có dạng như sau (chỉ một phần của phản hồ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

Các lựa chọn cấu hình vai trò nhà phát triển sau đây được cung cấp cho API:

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

Bạn có thể lấy mức thuế hiện tại của nhà phát triển bằng cách gửi yêu cầu GET đến 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 của nhà phát triển dưới dạng một 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 dành riêng cho nhà phát triển bằng API

Bạn có thể thực hiện nhiều việc liên quan đến việc kiếm tiề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 những việc này cho một nhà phát triển cá nhân. Ví dụ: bạn có thể tạo một 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 tác vụ 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 tác vụ này.