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 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 chương trình API 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 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 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 để 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ý, 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ủa bạ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, trước tiên họ phải có tài khoản quản trị viên Apigee riêng.
• Nếu bạn chỉ cần tạo nhà phát triển kiểm thử 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 bằng nhà phát triển kiểm thử giả mạo), 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ô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ả dưới đây.

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 cấu hình thanh toán 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 phần Đị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 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 tuỳ chỉnh.
   3. Lặp lại để thêm các thuộc tính tuỳ chỉnh khác vào 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 công ty:

1. Truy cập vào trang Công ty.
2. Đặt con trỏ lên công ty mà bạn muốn kích hoạt rồi 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. Đặt con trỏ lên công ty mà bạn muốn chỉnh sửa rồi 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

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

1. Truy cập vào trang Công ty.
2. Đặt 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ác 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 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ý 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 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 nhà phát triển. Bạn có thể xem các thuộc tính tuỳ chỉnh về việc kiếm tiền được đặt bằng API tiêu chuẩn (không phải về việc 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. 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 một số 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 đưa ra 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ả vai trò cũng như thông tin nhận dạng của tổ chức trong phần 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 đưa ra 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ỉ hiển thị một phần phản hồi):

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

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

API hiển thị các tuỳ 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ể lấy mức thuế hiện tại cho một nhà phát triển bằng cách đưa ra 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 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 nhiệm vụ liên quan đến việc kiếm tiền cho một tổ chức, chẳng hạn như tạo gói giá hoặc tạo điều kiện thông báo, cũng như cho một nhà phát triển cá nhâ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 nhiệm 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 nhiệm vụ này.