發送消費信息

使用從附加服務傳輸消費信息，當應用用戶請求退款時，您可以將用戶消費行為信息發送到應用市場。此API允許Hive伺服器向開發者的應用伺服器發送請求，然後開發者的伺服器將響應返回給Hive伺服器。

概述¶

要發送到應用市場的消費者資訊還包含僅存在於遊戲伺服器上的數據。因此，為了讓 Hive 伺服器將這些數據發送到應用市場，遊戲伺服器必須將數據傳遞給 Hive 伺服器。

遊戲伺服器 URL 是 遊戲伺服器開放的 API 端點，供遊戲伺服器將資料發送到 Hive 伺服器。根據以下協議配置 API 端點並將其註冊到遊戲伺服器 URL 後，Hive 伺服器將在每次用戶請求退款時向此 API 端點發送 POST 請求，並從遊戲伺服器接收必要的資料。Hive 伺服器匯總這些資料，並代表應用開發者完成消費者資訊向應用市場的傳輸。

總結來說，整個過程如下。

1. 應用程式開發者：透過配置API端點準備伺服器URL
2. 應用程式開發者：在Hive控制台中選擇啟用消費資訊傳輸並註冊伺服器URL
3. 應用程式使用者：在應用程式運行時同意傳輸應用內產品消費資訊
4. 應用程式使用者：在應用程式中請求退款
5. Hive伺服器：向應用程式開發者註冊的伺服器URL發送POST API請求，並接收數據作為回應
6. Hive伺服器：將消費資訊傳輸到應用市場

API 端點配置 (伺服器 URL)¶

API 端點必須與伺服器 URL 註冊，當收到請求時，必須聚合遊戲用戶特定數據（consumption_status、play_time、refund_preference、sample_content_provided），並以聚合數據回應，這些數據可以使用請求參數中的用戶信息（CS_CODE）進行查詢。

禁用防火牆規則¶

禁用防火牆入站規則允許遊戲伺服器與 Hive 伺服器之間的 API 通信。您需要在遊戲伺服器上為以下 IP 位址禁用防火牆入站規則。

在禁用防火牆規則後，請參考以下信息以配置 API 端點。

API 請求 (Hive 伺服器 → 遊戲伺服器) 配置¶

這是從Hive伺服器發送到遊戲伺服器的POST請求資訊。

以下是請求主體信息。

以下是請求主體的範例。

{
    "gameindex": "539",
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "user_seq": "222333"
}

API 回應 (遊戲伺服器 → Hive 伺服器) 配置¶

這是當響應成功時，必須從遊戲伺服器發送到 Hive 伺服器的響應值資訊。

以下是當回應成功時的回應值範例。

// success
{
    "code": 100,
    "message": "OK",
    "data": {
        "consumption_status": 0,
        "play_time": 1,
        "refund_preference": 2,
        "sample_content_provided": 0
    }
}

以下是響應失敗時的回應值示例。

// Errors due to wrong parameters
{
    "code": 400,
    "message": "No parameter, or invalid parameter name."
}

// Errors due to invalid user information
{
    "code": 200,
    "message": "No data, or invalid cs_code."
}

這裡是回應代碼。