Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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.
Truy cập vào tài liệu Apigee X. thông tin

Nếu bạn có những nhà phát triển hiện tại cần di chuyển sang mục Kiếm tiền:

Tạo các sản phẩm API, gói API và kế hoạch giá cho những nhà phát triển mà bạn đang di chuyển, nếu họ chưa có. Để biết thêm thông tin, hãy xem:
Xuất bản gói giá, như mô tả trong phần Xuất bản gói giá.
Thêm nhà phát triển mới vào tổ chức của bạn, như mô tả trong phần Đăng ký nhà phát triển ứng dụng.
Nạp tiền vào số dư trả trước cho mỗi nhà phát triển, như mô tả trong phần Quản lý số dư tài khoản trả trước.
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.

Nếu nhà phát triển mà bạn đang di chuyển có các giao dịch hiện tại, thì bạn có thể chuyển thông tin sử dụng 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 không 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, 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 1.000 bằng cách gọi tài nguyên transactions và đặt thuộc tính batchSize thành 1.000 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 theo cách thủ công, 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 nhà phát triển.	Không áp dụng	Có
`batchSize`	Số lượng giao dịch bạn muốn chuyển.	1	Không
`custAttn`	Giá trị của thuộc tính tùy chỉnh được dùng với batchSize để tính mức sử dụng giao dịch. Bạn phải chỉ định số thuộc tính tuỳ chỉnh trong thông báo 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 sử dụng giá trị âm. Bạn phải xác định thuộc tính tùy chỉnh trong: Chính sách ghi lại giao dịch cho sản phẩm API. Xem phần Định cấu hình chính sách ghi lại giao dịch. Gói giá còn hiệu lực cho sản phẩm API. Xem phần Định cấu hình gói giá có thuộc tính tuỳ chỉnh.	Không áp dụng	Có
`product`	Mã nhận dạng của sản phẩm API.	Không áp dụng	Có
`type`	Phải được đặt thành `CHARGE` (theo 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ì 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ố 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 đặt 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 tùy 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

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 chế độ 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 phần 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á, 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ệ được 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`	Phí thiết lập hoặc phí định kỳ cần tính.	Không áp dụng	Có
`ratePlan`	Mã 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à bắt 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, thì ?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 USD 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