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 có các nhà phát triển hiện tại mà bạn cần di chuyển sang chương trình 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 đang di chuyển, nếu các sản phẩm, gói và gói giá này chưa tồn tại. Để biết thêm thông tin, hãy xem:
  2. Xuất bản gói giá, như 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, như mô tả trong bài viết Đă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ý số dư tài khoản trả trước.
  5. Chấp nhận gói giá, như mô tả trong phần Mua gói giá 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 tham số truy vấn waivefees thành true.

  6. Nếu nhà phát triển mà bạn đang di chuyển có các giao dịch hiện có, bạn có thể chuyển giao dịch theo cách thủ công 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 chưa có giao dịch nào, thì bạn có thể bỏ qua bước này.

    Tài nguyên transactions chèn một giao dịch 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 đã đưa ra 1.000 lệnh gọi đến API trước khi di chuyển, thì để nắm bắt hoạt động hiện tại, bạn có thể thiết lập mức sử dụng giao dịch thành 1.000 bằng cách gọi 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 phần nội dung yêu cầu để đặt số lượng giao dịch, giá trị mặc định của các giao dịch đó và liệu các giao dịch đó có bắt buộc hay không.

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

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

    		 Không áp dụng Có
    batchSize

    Số 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 sử dụng với batchSize để tính toán mức sử dụng giao dịch.

    Số thuộc tính tuỳ chỉnh trong thông báo 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). Không được phép sử dụng giá trị âm.

    Bạn phải xác định thuộc tính tuỳ chỉ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 (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 tham số 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 sẽ được thực thi. Ví dụ: nếu một nhà phát triển trả trước có số dư bằng 0 và hoạt động trên tài khoản bị tạm ngưng, thì yêu cầu sẽ không thành công trong quá trình xác thực nếu ?force=false.

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

    $ 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 và sản phẩm API được chỉ định. Trong yêu cầu, batchSize được đặt thành 125 và giá trị cho 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. Khi nhân với nhau, 125 * 0,1 sẽ 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 phí thiết lập hoặc phí định kỳ cần thiết, bạn có thể tính phí thiết lập hoặc phí định kỳ cho một gói giá theo cách thủ công 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 phí thiết lập hoặc phí định kỳ, 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 phí thiết lập hoặc 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 phần nội dung yêu cầu để tính phí thiết lập hoặc phí định kỳ cho một gói giá theo cách thủ công, giá trị mặc định của các thuộc tính đó và liệu các thuộc tính đó 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 Thụy 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 thông số 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 sẽ được thực thi. Ví dụ: nếu nhà phát triển trả trước có số dư bằng 0 và hoạt động trên tài khoản bị tạm ngưng, nếu ?force=false thì 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 sẽ 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