排解營利問題

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

本主題提供資訊與指引，說明如何解決常見的觀察到的營利問題 如要解決關聯問題，可用 Apriori 這類關聯規則學習技術和演算法

開發人員已遭停權

問題

開發人員已遭停權，而且無法再獲得其他營利 交易量/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 >利率規劃名稱 >價目表

    例如，如果套件名稱是「Pro Package」， 是免費方案，則路徑會是：

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

NO_CURRENT_PUBLISHABLE_ENTITY

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

營利設定問題

症狀

營利設定問題可能出現以下各種症狀：

  • Webhook 功能無法運作
  • 無法建立 Webhook
  • 未觸發 Webhook 通知
  • 營利報表未顯示任何交易。例如： Analytics 資料顯示該開發人員 特定時間範圍內的交易資料 但「營利」報表 不會列出任何交易。
  • 未記錄交易

錯誤訊息

您可能不會看到任何錯誤訊息，但您會在 相關資訊請見症狀 專區。

可能原因

如果發現 症狀， 這些交易很有可能是因為交易無法營利

正在診斷原因

  1. 使用下一節所述的 Management API 呼叫來完成以下作業： 確認交易是否用於營利

    查看交易狀態

  2. 如果沒有看到任何交易顯示為「成功」SUCCESS 指定時限內，該交易就無法營利。

導致交易無法營利的常見原因包括：

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

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

診斷

  1. 檢查《營利限制檢查政策》是否已附加至 API Proxy。
  2. 如未附加這項政策，這可能就是列出交易的原因 FAILED。

解析度

將「營利限制檢查政策」附加至必要的 API Proxy。 對 API Proxy 強制執行營利限制。

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

API 產品未用於營利

診斷

  1. 確認 API 產品是否已啟用營利功能 (只有營利 API 產品會受到分級， 列在交易中營利產品是指至少有一個有效的費率方案 廣告。
  2. 請使用下列 Management 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」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. 使用下列 Management 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. 如果您是 Private 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 支援團隊聯絡。