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 các vấn đề thường gặp liên quan đến việc kiếm tiề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ể thực hiện thêm bất kỳ giao dịch kiếm tiền/lệnh gọi API nào.
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:
- Thực thi lệnh gọi API sau đây để xác định mã lỗi liên quan đến nhà phát triển bị tạm ngưng:
- Nếu bạn là Người dùng Cloud công cộng, hãy sử dụng API bên dưới:
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 Cloud công cộng, hãy sử dụng API bên dưới:
- So sánh mã lỗi với các mã lý do sau đây để xác định lý do nhà phát triển bị tạm ngưng.
Xem thêm: Tóm tắt mã lý do dành cho nhà phát triển bị tạm ngưng hoạt độ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 để thực hiện thêm bất kỳ giao dịch nào, 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 đặt cho đơn vị tiền tệ được sử dụng đã hết. |
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 một số lượng giao dịch cố định dựa trên gói giá đã mua. Nếu vượt quá số lượng giao dịch, nhà phát triển sẽ bị tạm ngưng và không thể hoàn tất thêm giao dịch. |
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 cứ 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 để hoàn tất mọi giao dịch bổ sung. |
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ể biểu hiện qua nhiều dấu hiệu, chẳng hạn 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 của Analytics cho thấy nhà phát triển đã hoàn tất 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 liệt kê bất kỳ giao dịch nào trong số đó.
- Giao dịch không được ghi lại
Thông báo lỗi
Bạn có thể không nhìn thấy thông báo lỗi nào, nhưng sẽ thấy các vấn đề như được giải thích trong phần Dấu hiệu.
Nguyên nhân có thể xảy ra
Nếu bạn thấy bất kỳ triệu chứng nào nêu trong Triệu chứng, thì rất có thể giao dịch đó 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 dùng để 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à THÀNH CÔNG trong khoảng thời gian đã chỉ định, thì tức là giao dịch đó không được kiếm tiền.
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 với proxy API
- APIProduct không dùng để kiếm tiền
- Xác định không chính xác chính sách ghi lại giao dịch
- 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 các proxy API hay không.
- Nếu bạn không đính kèm chính sách này, thì đây có thể là lý do khiến các giao dịch bị liệt kê là FAILED (KHÔNG THÀNH CÔNG).
Độ 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ư mô tả trong phần Thực thi giới hạn kiếm tiền đối với proxy API.
Nếu vấn đề vẫn tiếp diễn, hãy kiểm tra Sản phẩm API không dùng để 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ó được dùng để kiếm tiền hay không (chỉ các sản phẩm API dùng để kiếm tiền mới được xếp hạng và sẽ được liệt kê 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ử dụng lệnh gọi API quản lý sau đây để nhận danh sách các sản phẩm API kiếm tiền:
- Nếu bạn là Người dùng Cloud công cộng, hãy sử dụng API bên dưới:
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 Cloud công cộng, hãy sử dụng API bên dưới:
- Nếu sản phẩm API được liên kết với Proxy API của bạn không dùng để kiếm tiền, thì đây có thể là lý do khiến các giao dịch không được 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 giao dịch bị xác định không chính xác.
Xác định không chính xác chính sách ghi lại giao dịch
Chẩn đoán
- Bật tính năng theo dõi giao diện người dùng cho Proxy API có đính kèm Chính sách kiểm tra giới hạn kiếm tiền.
- Chọn một yêu cầu API cụ thể từ dấu vết giao diện người dùng.
- Chọn quy trình AX Analytics và kiểm tra xem các biến luồng kiếm tiền (mint)
sau đây có giá trị thích hợp hay không:
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à dấu vết giao diện người dùng mẫu cho thấy các biến luồng đúc tiền được thiết lập chính xác.
- Nếu bạn nhận thấy lỗi trong biến
mint.tx.status
, thì tức là biến này cho biết chính sách ghi lại giao dịch được xác định không chính xác.
Độ phân giải
- Đảm bảo rằng bạn đã tuân thủ đúng tất cả các bước nêu trong bài viết Tạo chính sách ghi lại giao dịch khi tạo chính sách ghi lại giao dịch.
- Giá trị khoá là "tiêu chí thành công của giao dịch" được đặt trong chính sách ghi lại giao dịch. Xem phần Ví dụ về việc 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
- Sử dụng lệnh gọi API quản lý sau đây để xác minh các gói giá mà nhà phát triển đã mua:
- Nếu bạn là người dùng Cloud công khai, hãy sử dụng API bên dưới:
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 bên dưới:
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 Cloud công khai, hãy sử dụng API bên dưới:
- Dựa trên phản hồi từ lệnh gọi trên, hãy tìm gói đã hoạt động tại thời điểm nhà phát triển hoàn tất giao dịch.
Độ phân giải
Nhà phát triển phải mua gói giá dựa trên yêu cầu của họ, sau đó thực thi các 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ợ của Apigee.