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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Danh mục nhà phát triển là một nhóm các nhà phát triển hoặc công ty có đặc điểm tương tự nhau, 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 gói 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 đó. Để biết thêm thông tin về cách tạo gói giá bằng danh mục nhà phát triển, hãy xem bài viết 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ẽ hiển thị.

Như được làm nổi bật 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á danh mục nhà phát triển

Edge phiên bản cũ (Đám mây riêng)

Cách truy cập trang 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ẽ hiển thị.

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á 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 Phát triển danh mục.
  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 gọn cho danh mục mới.
  4. Nhấp vào Tạo danh mục nhà phát triển.

Thêm 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ột công ty chỉ có thể thuộc một danh mục nhà phát triển.

Cách thêm 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 Phát triển danh mục.
  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 .
  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 Phát triển danh mục.
  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 cho /mint/organizations/{org_name}/developer-categories.

Khi đưa ra yêu cầu, bạn chỉ định danh mục namedescription 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 gửi yêu cầu POST 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 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 gửi yêu cầu PUT tương ứng đến các tài nguyên sau:

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

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

Chỉ định MINT_DEVELOPER_CATEGORY làm thuộc tính trong phần nội dung yêu cầu với giá trị là mã nhận dạng nội bộ của danh mục. 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", danh mục này 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 các 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 danh mục nhà phát triển cụ thể bằng cách gửi yêu cầu GET tới /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là thông tin nhận dạng 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 một yêu cầu PUT cho /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là thông tin nhận dạng danh mục cần cập nhật. Bạn cần chỉ định trong phần nội dung yêu cầu các chế độ cài đặt đã cập nhật và mã nhận dạng của 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 đưa ra yêu cầu XOÁ đến /mint/organizations/{org_name}/developer-categories/{category_id}, trong đó {category_id} là mã 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 tài sản. Đặt thành MINT_DEVELOPER_CATEGORY.

Không áp dụng
value

Mã 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.