Quản lý danh mục nhà phát triển

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

Danh mục nhà phát triển là một nhóm nhà phát triển hoặc công ty có các đặc điểm tương tự, cho phép bạn định cấu hình hoạt động kiếm tiền để hoạt động trên danh mục cụ thể đó. Ví dụ: bạn có thể tạo các kế hoạch giá áp dụng cho tất cả nhà phát triển phát triển ứng dụng để chia sẻ doanh thu bằng cách tạo một danh mục nhà phát triển có tên là "revenue_sharing" và thêm nhà phát triển vào danh mục đó. Để biết thêm thông tin về cách tạo gói giá theo danh mục nhà phát triển, hãy xem phần Tạo gói giá.

Khám phá trang Danh mục nhà phát triển

Truy cập vào trang Danh mục nhà phát triển bằng giao diện người dùng Edge hoặc giao diện người dùng Edge cũ, như mô tả trong các phần sau.

Giao diện người dùng Edge

Cách truy cập vào trang Phát triển danh mục:

  1. Đăng nhập vào apigee.com/edge.
  2. Chọn Xuất bản > Kiếm tiền > Danh mục nhà phát triển trong thanh điều hướng bên trái.

Trang Danh mục nhà phát triển sẽ xuất hiện.

Như minh hoạ trong hình, trang Danh mục nhà phát triển cho phép bạn:

  • Xem các danh mục nhà phát triển hiện tại
  • Thêm, chỉnh sửa hoặc xoá một danh mục nhà phát triển

Classic Edge (Private Cloud)

Cách truy cập trang Develop Categories (Phát triển danh mục) bằng giao diện người dùng Edge phiên bản cũ:

  1. Đă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ý.
  2. Chọn Xuất bản > Danh mục nhà phát triển trong thanh điều hướng trên cùng.

Trang Danh mục nhà phát triển sẽ xuất hiện.

Trang Danh mục nhà phát triển cho phép bạn:

  • Xem các danh mục nhà phát triển hiện tại
  • Thêm, chỉnh sửa hoặc xoá một danh mục nhà phát triển

Thêm danh mục nhà phát triển

Cách thêm danh mục nhà phát triển bằng giao diện người dùng:

  1. Truy cập vào trang Danh mục phát triển.
  2. Nhấp vào + Danh mục nhà phát triển.
  3. Nhập tên và nội dung mô tả ngắn cho danh mục mới.
  4. Nhấp vào Tạo danh mục nhà phát triển.

Thêm một công ty vào danh mục nhà phát triển

Thêm một công ty vào danh mục nhà phát triển. Mỗi công ty chỉ có thể thuộc về một danh mục nhà phát triển.

Cách thêm một công ty vào danh mục nhà phát triển:

  1. Chọn Xuất bản > Công ty trong thanh điều hướng trên cùng.
  2. Chọn công ty mà bạn muốn thêm vào danh mục nhà phát triển.
  3. Nhấp vào Chỉnh sửa trên trang công ty.
  4. Chọn Danh mục nhà phát triển cho công ty.
  5. Nhấp vào Lưu.

Chỉnh sửa danh mục nhà phát triển

Cách chỉnh sửa danh mục nhà phát triển bằng giao diện người dùng:

  1. Truy cập vào trang Danh mục phát triển.
  2. Di chuyển con trỏ lên danh mục nhà phát triển mà bạn muốn chỉnh sửa rồi nhấp vào biểu tượng .
  3. Nhập danh mục nhà phát triển.
  4. Nhấp vào Cập nhật danh mục nhà phát triển.

Xoá danh mục nhà phát triển

Cách xoá danh mục nhà phát triển bằng giao diện người dùng:

  1. Truy cập vào trang Danh mục phát triển.
  2. Đặt con trỏ lên danh mục nhà phát triển mà bạn muốn chỉnh sửa.
  3. Nhấp vào .
  4. Nhấp vào Xoá để xác nhận thao tác.

Quản lý danh mục nhà phát triển bằng API

Quản lý danh mục nhà phát triển bằng API, như mô tả trong các phần sau.

Thêm danh mục nhà phát triển bằng API

Thêm danh mục nhà phát triển bằng cách gửi yêu cầu POST đến /mint/organizations/{org_name}/developer-categories.

Khi đưa ra yêu cầu, bạn phải chỉ định cả danh mục name và description trong tải trọng. Ví dụ:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

Phản hồi sẽ có dạng như sau:

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

Thêm nhà phát triển hoặc công ty vào danh mục nhà phát triển bằng API

Thêm nhà phát triển hoặc công ty vào danh mục nhà phát triển khi bạn thêm hoặc chỉnh sửa công ty hoặc nhà phát triển bằng cách phát hành yêu cầu POST tương ứng cho các tài nguyên sau:

  • /organizations/{org_name}/companies
  • /organizations/{org_name}/developers

Để thêm nhà phát triển hoặc công ty vào một danh mục nhà phát triển khi bạn chỉnh sửa công ty hoặc nhà phát triển, hãy đưa ra yêu cầu PUT đối với các tài nguyên sau đây, theo thứ tự:

  • /organizations/{org_name}/companies/{company_id}
  • /organizations/{org_name}/developers/{developer_id}

Mỗi công ty hoặc nhà phát triển chỉ có thể thuộc về một danh mục nhà phát triển.

Chỉ định MINT_DEVELOPER_CATEGORY làm thuộc tính trong nội dung yêu cầu với mã nhận dạng nội bộ của danh mục làm giá trị. Ví dụ: yêu cầu sau đây sẽ thêm một nhà phát triển hiện có vào danh mục nhà phát triển có tên là "Vàng" và có mã nhận dạng là aa6f960a-d9fd-416e-be39-c071418aabd0.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

Xem danh mục nhà phát triển bằng API

Xem một danh mục nhà phát triển cụ thể hoặc tất cả danh mục nhà phát triển trong một tổ chức.

Xem một danh mục nhà phát triển cụ thể bằng cách đưa ra yêu cầu GET đến /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là thông tin nhận dạng của danh mục nhà phát triển (mã nhận dạng được trả về trong phản hồi khi bạn thêm danh mục nhà phát triển). Ví dụ:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Xem tất cả danh mục nhà phát triển API cho một tổ chức bằng cách đưa ra yêu cầu GET đến /mint/organizations/{org_id}/developer-categories. Ví dụ:

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

Chỉnh sửa danh mục nhà phát triển bằng API

Chỉnh sửa danh mục nhà phát triển bằng cách gửi yêu cầu PUT đến /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là mã nhận dạng của danh mục cần cập nhật. Bạn cần chỉ định trong nội dung yêu cầu các chế độ cài đặt đã cập nhật và mã nhận dạng danh mục nhà phát triển. Ví dụ: yêu cầu sau đây chỉnh sửa nội dung mô tả của một danh mục nhà phát triển:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

Xoá danh mục nhà phát triển bằng API

Xoá một danh mục nhà phát triển bằng cách gửi yêu cầu XOÁ đến /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là thông tin nhận dạng của danh mục nhà phát triển cần xoá. Ví dụ:

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Thuộc tính cấu hình danh mục nhà phát triển cho API

Bảng sau đây tóm tắt các thuộc tính cấu hình có thể được đặt bằng API.

Tên Mô tả Mặc định Bắt buộc?
name

Tên cơ sở lưu trú. Đặt thành MINT_DEVELOPER_CATEGORY.

 Không áp dụng Có
value

Mã nhận dạng của danh mục nhà phát triển mà nhà phát triển được thêm vào.

 Không áp dụng Có, để đặt danh mục nhà phát triển.