排解營利問題

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

本主題提供資訊和指引，協助排解常見的營利問題。

開發人員帳戶遭停權

問題

開發人員已遭停權，無法再進行任何營利交易/API 呼叫。

錯誤訊息

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

診斷

如要瞭解開發人員遭到停權的原因，請按照下列步驟操作：

  1. 執行下列 API 呼叫，找出與遭停權開發人員相關聯的錯誤代碼：
    1. 如果您是公有雲使用者，請使用下列 API： 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. 如果您是私有雲使用者，請使用下列 API： 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. 請將錯誤代碼與下列原因代碼進行比較，判斷開發人員遭到停權的原因。

另請參閱：遭停權開發人員的理由代碼摘要

原因代碼

原因

詳細資料

INSUFFICIENT_FUNDS

開發人員帳戶餘額不足

如果預付開發人員帳戶餘額不足以支付任何額外交易，開發人員就會遭到停權。

如果是後付型開發人員，如果超出信用額度，或是所用幣別的信用額度已用盡，就可能發生這個錯誤。

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

開發人員無法再進行任何交易

每位開發人員可進行的交易次數上限，取決於購買的費率方案。如果超過交易次數上限，開發人員就會遭到停權，無法完成其他交易。

NO_CURRENT_PUBLISHABLE_ENTITY

開發人員尚未購買任何費率方案

開發人員必須先購買費率方案，才能完成任何交易。

解析度

錯誤

解決步驟

INSUFFICIENT_FUNDS

開發人員必須確保帳戶餘額或可用抵免額充足，才能完成任何額外交易。

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. 請發出下列 API 呼叫，分別取得開發人員費率方案和交易明細：
    • 執行下列 API 呼叫，取得開發人員購買的費率方案開始和結束日期： 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • 執行下列 API 呼叫，取得開發人員的成功交易次數： 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. 在 Edge UI 中，您也可以選取下列項目，查看開發人員可進行的呼叫次數：

    「Packages」>「PackageName」>「RatePlanName」>「Rate Card」

    舉例來說，如果套件名稱為「Pro Package」，且為「Free Plan」，則路徑會是：

    套裝方案 > Pro 套裝方案 > 免費方案 > 費率表

NO_CURRENT_PUBLISHABLE_ENTITY

開發人員必須購買費率方案，才能發出 API 呼叫。

營利設定問題

症狀

營利設定問題可能包括下列情況：

  • Webhook 功能無法運作
  • 無法建立 Webhook
  • Webhook 通知未觸發
  • 營利報表未顯示任何交易。舉例來說，Analytics 資料顯示開發人員在特定時間內完成許多交易，但「營利」報表未列出任何交易。
  • 交易未記錄

錯誤訊息

您可能不會看到任何錯誤訊息，但會發現「症狀」一節所述的問題。

可能原因

如果出現「症狀」一節列出的任何症狀，交易很可能無法營利。

診斷原因

  1. 使用下一節說明的管理 API 呼叫，確認交易是否已營利。

    查看交易狀態

  2. 如果在指定時間內，沒有任何交易顯示為「成功」，表示這些交易未營利。

交易無法營利的常見原因如下：

下列各節說明如何診斷及解決各項問題。

API Proxy 未使用營利限制檢查政策

診斷

  1. 檢查 API Proxy 是否附加營利限制檢查政策。
  2. 如果未附加政策，交易可能因此列為「失敗」。

解析度

按照「 對 API Proxy 強制執行營利限制」一文的說明，將營利限制檢查政策附加至必要的 API Proxy。

如果問題仍未解決，請檢查 API 產品未營利。

API 產品未營利

診斷

  1. 確認 API 產品是否已營利 (只有營利的 API 產品會獲得評分，並列在交易下方)。營利產品是指至少有一個有效費率方案的產品。
  2. 使用下列管理 API 呼叫，取得已營利 API 產品的清單：
    1. 如果您是公有雲使用者，請使用下列 API： 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. 如果您是私有雲使用者，請使用下列 API： 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. 如果與 API Proxy 相關聯的 API 產品未營利，這可能是交易未營利的原因。

解析度

如要透過 API 產品營利，請按照下列步驟操作：

  1. 設定交易記錄政策。

  2. 確認 API 產品有有效的費率方案。

如果問題仍未解決，請檢查 交易記錄政策是否定義有誤。

交易記錄政策定義有誤

診斷

  1. 為附加營利限制檢查政策的 API Proxy 啟用 UI 追蹤功能。
  2. 從 UI 追蹤記錄中選取特定 API 要求。
  3. 選取 Analytics AX 流程，並檢查下列營利 (鑄造) 流程變數是否具有適當的值：
    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. 以下是範例 UI 追蹤記錄，顯示鑄造流程變數已正確設定。

  5. 如果觀察到 mint.tx.status 變數發生錯誤，表示交易記錄政策定義有誤。

解析度

  1. 建立交易記錄政策時，請務必正確按照「 建立交易記錄政策」一文中的所有步驟操作。
  2. 主要值是在交易記錄政策中設定的「交易成功條件」。請參閱 在交易記錄政策中設定交易成功條件的範例

開發人員尚未購買費率方案

診斷

  1. 使用下列管理 API 呼叫，驗證開發人員購買的費率方案：
    1. 如果您是公有雲使用者，請使用下列 API： 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. 如果您是私有雲使用者，請使用下列 API： 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. 根據上述呼叫的回應，找出開發人員完成交易時有效的方案。

解析度

開發人員必須根據需求購買費率方案，然後執行交易/API。

如果問題仍未解決，請與 Apigee Edge 支援團隊聯絡。