Chuyển nhà phát triển sang mô hình kiếm tiề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

Nếu bạn đang có các nhà phát triển cần chuyển sang Kiếm tiền:

  1. Tạo sản phẩm API, gói API và gói giá cho các nhà phát triển mà bạn là nhà phát triển di chuyển, nếu chúng chưa tồn tại. Để biết thêm thông tin, hãy xem:
  2. Xuất bản gói giá theo mô tả trong phần Xuất bản gói giá.
  3. Thêm các nhà phát triển mới vào tổ chức của bạn, theo mô tả trong phần Đăng ký nhà phát triển ứng dụng.
  4. Nạp tiền vào số dư trả trước cho từng nhà phát triển, theo mô tả trong bài viết Quản lý tài khoản trả trước số dư.
  5. Chấp nhận gói giá, như mô tả trong phần Tỷ lệ mua bằng API.

    Lưu ý: Để miễn phí thiết lập, nếu nhà phát triển đã bị tính phí, hãy đặt giá trị waivefees tham số truy vấn cho true.

  6. Nếu nhà phát triển mà bạn đang di chuyển đã có các giao dịch, bạn có thể chuyển việc sử dụng giao dịch theo cách thủ công bằng tài nguyên sau:
    /organizations/{org_name}/transactions, trong đó {org_name} là tên của tổ chức.

    Lưu ý: Nếu nhà phát triển chưa có giao dịch nào, bạn có thể bỏ qua bước này .

    Tài nguyên transactions chèn một giao dịch duy nhất phản ánh mức sử dụng giao dịch hiện tại và cập nhật tất cả các bộ đếm nội bộ để phản ánh giá trị mới này.

    Ví dụ: nếu nhà phát triển đã thực hiện 1.000 lệnh gọi đến API trước khi di chuyển, đến nắm bắt hoạt động hiện tại, bạn có thể đặt mức sử dụng giao dịch là 1000 bằng cách gọi hàm Tài nguyên transactions và đặt thuộc tính batchSize thành 1000 trong nội dung yêu cầu.

    Bảng sau đây tóm tắt các thuộc tính cấu hình mà bạn có thể chỉ định trong để thiết lập thủ công số lượng giao dịch, giá trị mặc định của chúng và liệu hoặc không bắt buộc.

    Thuộc tính Mô tả Mặc định Bắt buộc?
    application

    Mã ứng dụng của nhà phát triển.

    		 Không áp dụng Có
    batchSize

    Số lượng giao dịch mà bạn muốn chuyển.

    		 1 Không
    custAttn

    Giá trị của thuộc tính tuỳ chỉnh được dùng cùng với BulkSize để tính toán mức sử dụng giao dịch.

    Số thuộc tính tuỳ chỉnh trong thư phải được chỉ định dưới dạng số nguyên dương hoặc số thập phân (tối đa 4 chữ số thập phân). Giá trị âm không được phép.

    Thuộc tính tuỳ chỉnh phải được xác định trong:

    		 Không áp dụng Có
    product

    Mã của sản phẩm API.

    		 Không áp dụng Có
    type

    Phải được đặt thành CHARGE (đây là giá trị mặc định).

    		 CHARGE Không

    Để bỏ qua các bước xác thực và buộc đặt số lượng giao dịch, hãy đặt force tham số truy vấn đến true (ví dụ: ?force=true). Theo mặc định, ?force=false và các bước xác thực là thực thi. Ví dụ: Nếu một nhà phát triển trả trước có số dư và hoạt động trên tài khoản bằng 0 bị tạm ngưng, nếu ?force=false thì yêu cầu không thành công trong quá trình xác thực.

    Ví dụ: yêu cầu sau đây thiết lập số lượng giao dịch là 50 cho ứng dụng và sản phẩm API:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize":50
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password

    Yêu cầu sau đây thiết lập mức sử dụng giao dịch thành 12.5 cho ứng dụng được chỉ định và Sản phẩm API. Trong yêu cầu, batchSize được thiết lập thành 125 và giá trị đối với thuộc tính tuỳ chỉnh đầu tiên được xác định cho sản phẩm API được đặt thành 0.1. Thời gian nhân với nhau, 125 * 0,1 bằng 12,5.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize": 125,
   "custAtt1" : 0.1
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password
  7. Nếu nhà phát triển chưa bị tính các khoản phí thiết lập hoặc phí định kỳ cần thiết, bạn có thể tự làm tính phí thiết lập hoặc phí định kỳ cho một gói giá bằng cách sử dụng tài nguyên sau:
    /organizations/{org_name}/transactions, trong đó {org_name} là tên của tổ chức.

    Lưu ý: Nếu nhà phát triển đã bị tính các khoản phí thiết lập hoặc phí định kỳ, thì bạn có thể bỏ qua bước này. Việc gọi tài nguyên transactions sẽ không ảnh hưởng đến việc thiết lập hoặc các khoản phí định kỳ do gói giá xác định.

    Bảng sau đây tóm tắt các thuộc tính cấu hình mà bạn có thể chỉ định trong nội dung yêu cầu tính phí thiết lập hoặc phí định kỳ theo cách thủ công cho một gói giá, mặc định và liệu chúng có bắt buộc hay không.

    Thuộc tính Mô tả Mặc định Bắt buộc?
    currency

    Đơn vị tiền tệ dùng cho gói giá. Chỉ định mã ISO 4217 cho đơn vị tiền tệ, chẳng hạn như usd cho đô la Mỹ hoặc chf cho franc Thuỵ Sĩ.

    		 Không áp dụng Có
    developer

    Mã nhận dạng của nhà phát triển.

    		 Không áp dụng Có
    rate

    Bạn cần trả phí thiết lập hoặc phí định kỳ.

    		 Không áp dụng Có
    ratePlan

    Mã của gói giá.

    		 Không áp dụng Có
    type

    Đặt thành SETUPFEES hoặc RECURRINGFEES.

    		 CHARGE Có

    Để bỏ qua các bước xác thực và buộc tính phí, hãy đặt truy vấn force thành true (ví dụ: ?force=true). Theo mặc định, ?force=false và các bước xác thực đã được thực thi. Ví dụ: nếu số dư nhà phát triển không có số dư bằng 0 và hoạt động trên tài khoản sẽ bị tạm ngưng nếu ?force=false yêu cầu sẽ không thành công trong quá trình xác thực.

    Ví dụ: yêu cầu sau đây tính phí thiết lập là 10 đô la Mỹ cho nhà phát triển đã đăng ký gói giá:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev1@myorg.com"
   },
   "currency":{
     "id":"usd"
   },
   "ratePlan":{
     "id":"mypackage_rateplan1"
   },   
   "rate":10,
   "type":"SETUPFEES"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password