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.
Tham khảo tài liệu về Apigee X. thông tin

Nếu một số nhà phát triển hiện tại của bạn cần chuyển sang phần Kiếm tiền:

  1. Tạo các sản phẩm API, gói API và gói giá cho các nhà phát triển mà bạn di chuyển (nếu chưa có). Để biết thêm thông tin, hãy xem bài viết:
  2. Phát hành các gói giá như mô tả trong phần Gói giá xuất bản.
  3. Thêm 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, như 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 Gói giá mua sử dụ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 một nhà phát triển mà bạn di chuyển đã có sẵn các giao dịch, bạn có thể chuyển dữ liệu 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 1000 lệnh gọi đến API trước khi di chuyển, thì để ghi lại hoạt động hiện tại, bạn có thể đặt mức sử dụng giao dịch thành 1000 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 để thiết lập số lượng giao dịch theo cách thủ công, giá trị mặc định của các giao dịch đó và liệu các thuộc tính đó có bắt buộc hay không.

    Tài sản 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ố giao dịch 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 lôSize để 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 giá trị số nguyên dương hoặc số thập phân (tối đa 4 chữ số thập phân). Bạn không được phép sử dụng giá trị âm.

    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 (mặc định).

    		 CHARGE Không

    Để bỏ qua các bước xác thực và buộc thiết lập 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, 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 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 sẽ đặt mức sử dụng giao dịch thành 12,5 cho ứng dụng và sản phẩm API đã 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 là 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í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 việc thiết lập hoặc phí định kỳ mà 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, các giá trị mặc định của các thuộc tính đó và liệu các giá trị đó có bắt buộc hay không.

    Tài sản Mô tả Mặc định Bắt buộc?
    currency

    Đơn vị tiền tệ dùng cho gói giá. Hãy chỉ định mã ISO 4217 cho đơn vị tiền tệ, chẳng hạn như đô la Mỹ hoặc chf cho đồng 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

    Phí thiết lập hoặc phí định kỳ để tính.

    		 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 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, 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 sẽ tính phí thiết lập là 10 đô la Mỹ đối với 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