Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Chủ đề này cung cấp thông tin và hướng dẫn về cách khắc phục sự cố thường gặp về hoạt động kiếm tiền vấn đề.
Nhà phát triển bị tạm ngưng
Triệu chứng
Nhà phát triển bị tạm ngưng và sẽ không thể kiếm tiền thêm giao dịch/lệnh gọi API.
Thông báo lỗi
<error>
<messages>
<message>Exceeded developer limit configuration -</message>
<message>Is Developer Suspended - true</message>
</messages>
</error>
Chẩn đoán
Để xác định lý do khiến nhà phát triển bị tạm ngưng, hãy thực hiện các bước sau các bước:
- Thực thi lệnh gọi API sau đây để xác định mã lỗi liên quan đến lệnh tạm ngưng
nhà phát triển:
- Nếu bạn là Người dùng đám mây công khai, hãy sử dụng API dưới đây:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password - Nếu bạn là Người dùng đám mây riêng tư, hãy sử dụng API bên dưới:
curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Nếu bạn là Người dùng đám mây công khai, hãy sử dụng API dưới đây:
- So sánh mã lỗi với các mã lý do sau để xác định lý do khiến nhà phát triển bị tạm ngưng.
Xem thêm: Tóm tắt về mã lý do cho nhà phát triển bị tạm ngưng
|
Mã lý do |
Nguyên nhân |
Chi tiết |
|
INSUFFICIENT_FUNDS |
Số dư tài khoản nhà phát triển đã cạn |
Nếu số dư tài khoản nhà phát triển trả trước không có đủ tiền để thanh toán thêm giao dịch thì nhà phát triển sẽ bị tạm ngưng. Đối với nhà phát triển trả sau, lỗi này có thể xảy ra nếu họ vượt quá hạn mức tín dụng hoặc nếu hạn mức tín dụng được đặt cho đơn vị tiền tệ được sử dụng đã cạn. |
|
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
Nhà phát triển không thể thực hiện thêm giao dịch nào |
Mỗi nhà phát triển được phép thực hiện số lượng giao dịch cố định dựa trên giá đã mua. Nếu vượt quá số lượng giao dịch thì nhà phát triển bị tạm ngưng và không thể hoàn tất giao dịch bổ sung. |
|
NO_CURRENT_PUBLISHABLE_ENTITY |
Nhà phát triển chưa mua gói giá nào |
Nhà phát triển phải mua gói giá trước khi hoàn tất bất kỳ giao dịch nào. |
Độ phân giải
|
Lỗi |
Các bước giải quyết |
|
INSUFFICIENT_FUNDS |
Nhà phát triển cần đảm bảo có đủ số dư tài khoản hoặc tín dụng hiện có để hoàn tất bất kỳ giao dịch bổ sung nào. |
|
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
|
|
NO_CURRENT_PUBLISHABLE_ENTITY |
Nhà phát triển phải mua một gói giá để có thể thực hiện lệnh gọi API. |
Vấn đề về việc thiết lập tính năng kiếm tiền
Hiện tượng
Các vấn đề về việc thiết lập tính năng Kiếm tiền có thể xuất hiện dưới các dấu hiệu như:
- Chức năng webhook không hoạt động
- Không thể tạo webhook
- Thông báo webhook không được kích hoạt
- Báo cáo kiếm tiền không cho thấy bất kỳ giao dịch nào. Ví dụ: dữ liệu Analytics cho biết rằng nhà phát triển đã hoàn thành nhiều giao dịch trong một khoảng thời gian cụ thể, nhưng báo cáo Kiếm tiền không được liệt kê bất kỳ giao dịch nào trong số đó.
- Giao dịch không được ghi nhận
Thông báo lỗi
Bạn có thể không thấy thông báo lỗi nào, nhưng sẽ thấy vấn đề xuất hiện được giải thích trong Triệu chứng .
Nguyên nhân có thể xảy ra
Nếu bạn gặp bất kỳ triệu chứng nào được nêu trong Triệu chứng thì đó là rất có thể các giao dịch đó sẽ không kiếm tiền được.
Chẩn đoán nguyên nhân
-
Hãy sử dụng lệnh gọi API quản lý được mô tả trong phần sau để kiểm tra xem các giao dịch đó có đang được kiếm tiền hay không.
- Nếu bạn không thấy giao dịch nào được liệt kê là SUCCESS trong thời hạn được chỉ định, thì các giao dịch không được kiếm tiền.
Các nguyên nhân điển hình khiến các giao dịch không được kiếm tiền là:
- Chính sách kiểm tra giới hạn kiếm tiền không được đính kèm trong proxy API
- APIProduct không được kiếm tiền
- Chính sách ghi lại giao dịch được xác định không chính xác
- Nhà phát triển chưa mua gói giá
Các phần sau đây mô tả cách chẩn đoán và giải quyết từng vấn đề.
Chính sách kiểm tra giới hạn kiếm tiền không được dùng trong Proxy API
Chẩn đoán
- Kiểm tra xem Chính sách kiểm tra giới hạn kiếm tiền có được đính kèm với proxy API hay không.
- Nếu chính sách không được đính kèm, thì đây có thể là lý do khiến giao dịch được liệt kê là FAILED.
Độ phân giải
Đính kèm Chính sách kiểm tra giới hạn kiếm tiền vào các proxy API bắt buộc, như được mô tả trong Thực thi giới hạn kiếm tiền trên proxy API.
Nếu sự cố vẫn tiếp diễn, khi đó hãy kiểm tra Sản phẩm API không được kiếm tiền.
Sản phẩm API không được kiếm tiền
Chẩn đoán
- Kiểm tra xem sản phẩm API có kiếm tiền hay không (chỉ các sản phẩm API kiếm tiền mới được xếp hạng và sẽ trong phần giao dịch). Sản phẩm kiếm tiền là sản phẩm có ít nhất một gói giá đang hoạt động sẵn có.
- Hãy sử dụng lệnh gọi API quản lý sau đây để tải danh sách các sản phẩm API kiếm tiền:
- Nếu bạn là Người dùng đám mây công khai, hãy sử dụng API dưới đây:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password - Nếu bạn là Người dùng đám mây riêng tư, hãy sử dụng API bên dưới:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Nếu bạn là Người dùng đám mây công khai, hãy sử dụng API dưới đây:
- Nếu sản phẩm API được liên kết với Proxy API của bạn không được kiếm tiền, thì đây có thể là lý do là các giao dịch không kiếm tiền.
Độ phân giải
Để kiếm tiền từ sản phẩm API, hãy thực hiện các bước sau:
- Định cấu hình chính sách ghi lại giao dịch.
- Kiểm tra để đảm bảo rằng Sản phẩm API có gói giá đang hoạt động.
Nếu vấn đề vẫn tiếp diễn, hãy kiểm tra Chính sách ghi lại giao dịch được xác định không chính xác.
Chính sách ghi giao dịch được xác định không chính xác
Chẩn đoán
- Bật dấu vết giao diện người dùng cho Proxy API có Chính sách kiểm tra giới hạn kiếm tiền được đính kèm.
- Chọn một yêu cầu API cụ thể trong dấu vết giao diện người dùng.
- Chọn quy trình AX trong Analytics và kiểm tra xem hoạt động kiếm tiền sau đây (mint)
biến luồng có giá trị phù hợp:
mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'. mint.tx.app_id - Application id of API product. mint.tx.prod_id - API product id.
Dưới đây là một dấu vết giao diện người dùng mẫu cho thấy các biến luồng quy trình đúc đã được thiết lập đúng cách.
- Nếu bạn nhận thấy lỗi trong biến
mint.tx.status, thì nó cho biết rằng chính sách ghi lại giao dịch không chính xác xác định.
Độ phân giải
- Hãy đảm bảo rằng tất cả các bước được nêu trong Tạo chính sách ghi lại giao dịch đã được tuân thủ đúng cách khi tạo chính sách ghi lại giao dịch.
- Giá trị chính là "tiêu chí giao dịch thành công" được đặt trong chính sách ghi lại giao dịch. Xem Ví dụ về cách thiết lập tiêu chí thành công của giao dịch trong chính sách ghi lại giao dịch
Nhà phát triển chưa mua gói giá
Chẩn đoán
- Hãy sử dụng lệnh gọi API quản lý sau đây để xác minh gói giá mà nhà phát triển đã mua:
- Nếu bạn là người dùng Đám mây công cộng, hãy sử dụng API dưới đây:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password - Nếu bạn là người dùng Đám mây riêng tư, hãy sử dụng API dưới đây:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Nếu bạn là người dùng Đám mây công cộng, hãy sử dụng API dưới đây:
- Dựa trên phản hồi từ cuộc gọi ở trên, hãy tìm kế hoạch đang hoạt động vào thời điểm đó giao dịch đã được nhà phát triển hoàn tất.
Độ phân giải
Nhà phát triển phải mua gói giá dựa trên các yêu cầu của họ, sau đó thực hiện giao dịch/API.
Nếu sự cố vẫn tiếp diễn, hãy liên hệ với Bộ phận hỗ trợ Apigee Edge.