排解營利問題

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

本主題提供常見營利問題的相關資訊和指引。

開發人員已遭停權

問題

開發人員已遭停權，無法再進行其他營利交易/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 中，您也可以選取下列選項，查看開發人員可發出的呼叫次數：

    套件 > PackageName > RatePlanName > 價目表

    例如，如果套件名稱為 Pro Package 且為 Free Plan，則路徑為：

    套件 > Pro 套裝方案 > 免費方案 > 價目表

NO_CURRENT_PUBLISHABLE_ENTITY

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

營利設定問題

症狀

營利設定問題可能出現多種症狀，例如：

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

錯誤訊息

您可能不會觀察到任何錯誤訊息，但會看到如「問題」一節中所述的問題。

可能原因

如果您看見症狀中列出的任何症狀，很可能表示相關交易無法營利。

診斷原因

  1. 請使用下一節所述的 Management API 呼叫，查看交易是否營利。

    查看交易狀態

  2. 如果在指定期間內未看到任何列為 SUCCESS 的交易，表示交易未用於營利。

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

以下各節將說明如何診斷並解決各項問題。

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 追蹤記錄範例，其中顯示已正確設定 Mint 流程變數。

  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. 如果您是私有 Cloud 使用者，請使用下列 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 支援團隊聯絡。