Khắc phục sự cố 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

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

Dấu hiệu

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:

1. 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:
   1. Nếu bạn là Người dùng đám mây công khai, 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

   2. 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

2. So sánh mã lỗi với các mã lý do sau để 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 đối với nhà phát triển bị tạm ngưng

Độ phân giải

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ề thiết lập tính năng kiếm tiền có thể biểu hiện dưới nhiều triệu chứng, 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 hiển thị giao dịch nào. Ví dụ: dữ liệu Analytics cho biết 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 về hoạt động kiếm tiền không liệt kê bất kỳ giao dịch nào trong số đó.
• Không ghi lại được giao dịch

Thông báo lỗi

Bạn có thể không thấy thông báo lỗi nào, nhưng bạn sẽ thấy các vấn đề như được giải thích trong phần Triệu chứng.

Nguyên nhân có thể dẫn đến vấn đề này

Nếu bạn gặp phải bất kỳ triệu chứng nào được liệt kê trong phần Triệu chứng, thì rất có thể các giao dịch đó không được kiếm tiền.

Chẩn đoán nguyên nhân

1. 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.

   Xem trạng thái của giao dịch

2. 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ì các giao dịch đó không được kiếm tiền.

Sau đây là những nguyên nhân thường gặp khiến các giao dịch không được kiếm tiền:

• Chính sách kiểm tra giới hạn kiếm tiền không được đính kèm vào proxy API
• APIProduct không được kiếm tiền
• Định nghĩa không chính xác về Chính sách ghi nhận giao dịch
• Nhà phát triển chưa mua gói cước

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

1. 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ào các proxy API hay không.
2. Nếu chính sách này chưa được đính kèm, thì đây có thể là lý do khiến các giao dịch được liệt kê là THẤT BẠI.

Độ 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 trên proxy API.

Nếu vấn đề vẫn tiếp diễn, hãy kiểm tra API Product is not monetized (Sản phẩm API không được kiếm tiền).

Sản phẩm API không kiếm tiền

Chẩn đoán

1. Kiểm tra xem sản phẩm API có được kiếm tiền hay không (chỉ những sản phẩm API được kiếm tiền mới được đánh giá và sẽ xuất hiện trong phần giao dịch). Sản phẩm có tính phí là sản phẩm có ít nhất một gói giá đang hoạt động.
2. Sử dụng lệnh gọi API quản lý sau đây để lấy danh sách các sản phẩm API được kiếm tiền:
   1. Nếu bạn là Người dùng đám mây công khai, 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

   2. 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

3. Nếu sản phẩm API được liên kết với API Proxy của bạn không được 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ừ một sản phẩm API, hãy thực hiện các bước sau:

1. Định cấu hình chính sách ghi lại giao dịch.

2. Kiểm tra để đảm bảo API Product có một 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 lại giao dịch được xác định không chính xác

Chẩn đoán

1. Bật tính năng theo dõi giao diện người dùng cho API Proxy có Chính sách kiểm tra giới hạn kiếm tiền được đính kèm.
2. Chọn một yêu cầu API cụ thể trong dấu vết giao diện người dùng.
3. Chọn luồng AX của Analytics và kiểm tra xem các biến luồng kiếm tiền (mint) sau đây có giá trị phù 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.

4. Sau đây là một dấu vết giao diện người dùng mẫu cho thấy các biến quy trình tạo được thiết lập chính xác.

   

5. Nếu bạn thấy lỗi trong biến mint.tx.status, thì điều đó có nghĩa là chính sách ghi nhận giao dịch được xác định không chính xác.

Độ phân giải

1. Đảm bảo rằng bạn đã làm theo đúng tất cả các bước được ghi lại trong 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.
2. Giá trị chính 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 Ví dụ về cách đặt 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 cước

Chẩn đoán

1. Sử dụng lệnh gọi API quản lý sau đây để xác minh các gói thuê bao mà nhà phát triển đã mua:
   1. Nếu bạn là người dùng Đám mây 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}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

   2. 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

2. Dựa trên phản hồi từ lệnh gọi ở trên, hãy tìm gói đang 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 hiện các giao dịch/API.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.